Configuring a Project's PHP Build Path
By configuring your project's PHP Build Path, you can select resources
which will be included or excluded from the Build process.
Note:
If during project creation you selected the 'use project
as source folder' under the Project Layout category, all resources within
the folder will be added to the Build Path by default.
If you selected to 'create separate folders for source files and public
resources' during the project's creation, resources in the 'public' folder
will be excluded from the Build Path by default.
The project's PHP Build Path can be configured through the project's
Build Path properties page, accessed by right-clicking the required project
and selecting Build Path | Configure Build Path.

This page allows you to add folders and resources to your Build Path
and configure rules for including / excluding certain resources in the
project.
You can configure your Build Path according
to the options listed below.
Once you have made changes, click OK to
save.
Note:
By default, all folders which are on your Build Path
will be included in your Include Path.
Configuring Inclusion/Exclusion
Patterns for the Project
By configuring inclusion/exclusion patterns for the Build Path, you
can select to include or exclude all resources in your project which match
a defined pattern.
|
|

|
To include/exclude resources from the Build
Path:
In the Build Path Properties
page, expand the node next to the folder whose Inclusion/Exclusion pattern
you want to configure and click Edit.
-Or- In PHP Explorer view, right-click the folder whose Inclusion/Exclusion
pattern you want to configure and select Build Path | Configure Inclusion
/ Exclusion Filters.
The Inclusion and Exclusion patterns dialog is displayed.
Click Add next to the Inclusion
or Exclusion patterns panes.
The Add Inclusion/Exclusion Pattern dialog is displayed.
Enter or select the required
resource(s) or pattern to include / exclude and click OK.
Click Finish.
|
All resources in the project which match an inclusion pattern but do
not match an exclusion pattern will be added to the Build Path. |
Configuring Different Inclusion/Exclusion Patterns for Folders Within
your Project
You can configure different inclusion/exclusion rules for child folders
within a selected directory. However, you will need to exclude the selected
child folder from the parent directory's Build Path and add it as a separate
Build Path source folder. This is done to resolve any conflicts which
may arise from configuring one pattern for the parent folder and another
for the child.
Source folders can be created and/or added from the PHP Build Path properties
page or from PHP Explorer view.
|
|

|
To add a directory as a separate source folder:
From the
PHP Build Path Properties page:
Click
Add Folder...
The Source Folder Selection dialog will display.
If
necessary, click Create New Folder to create a new folder.
Select
the required folder and click OK.
The
folder will be added as a separate source folder in the Build Path list.
Note:
In order to overcome the nesting conflict, you
should exclude the folder you have just added from the parent folder's
Build Path. See 'Configuring Inclusion/Exclusion
Patterns', above, for information on how to exclude the folder and
all resources contained within it.

From PHP
Explorer view:
Right-click
the project and select Build Path | New Source Folder.
The New Source Folder dialog will be displayed.


Enter the name for the new
folder in the Folder name field.
Adding a folder to a project's
Build Path could cause a conflict between the inclusion/exclusion patterns
configured for the project root and those configured for the selected
folder.
In order to avoid these nesting conflicts, select one of the following
options:
Replace existing project
source folder entry to solve nesting - This will remove your parent directory
as a source folder from the Build Path configuration and replace it with
the currently selected folder.
Update exclusion filters
in other source folders to solve nesting - This will exclude the currently
selected folder from the parent directory's Build Path but will add it
as a separate entity so that different inclusion/exclusion patters can
be configured for it.
Click Finish.
|
You can now configure a pattern for including/excluding resources for
the source folder by following the instructions under 'Configuring
Inclusion/Exclusion Patterns', above. |
Adding External Source Folders to the Build Path
You can add an external source folder as a link to your project which
will be scanned during the Build process.
|
|

|
To add an external source folder to the project's
Build Path:
In
the Build Path Properties page, click the 'Link Source...' button.
-Or- In PHP Explorer view, right-click the project and select Build
Path | Link Source.
The Link Source dialog is displayed.


Click
the 'Browse..' button and browse to the location of the folder you want
to add to the Build Path.
Alternately, click Variables and select the variable which points to
the required resource.
The Folder
name field will have been automatically populated with the name of the
original folder.
Edit this entry if required.
Adding
a folder to a project's Build Path could cause a conflict between the
inclusion/exclusion patterns configured for the project root and those
configured for the selected folder.
In order to avoid these nesting conflicts, select one of the following
options:
Replace existing project
source folder entry to solve nesting - This will remove your parent directory
as a source folder from the Build Path configuration and replace it with
the currently selected folder.
Update exclusion filters
in other source folders to solve nesting - This will exclude the currently
selected folder from the parent directory's Build Path but will add it
as a separate entity so that different inclusion/exclusion patters can
be configured for it.
Ignore nesting conflicts
- The selected folder will be added as a separate entity to the Build
Path list but will need to be manually excluded from the project root's
Build Path to avoid nesting conflicts.
Click Finish.
|
The folder will be added to your Build Path and displayed in the Build
Path list.
You can now configure a pattern for including/excluding
resources for the linked folder by following the instructions under 'Configuring Inclusion/Exclusion Patterns',
above. |