Include Paths

An Include Path is a location which connects elements created in external projects/libraries to the active project.

 

Projects/libraries added to a project's Include Path affect the following:

 

In 'include'/'require' calls, file locations can be defined in three ways:

  1. Absolute Path- The exact file location is specified (e.g. C:\Documents and Settings\MyProject\myfolder\a.php).

  2. Relative to the Current Working Directory - File names preceded with a "./" or a "../" These will only be searched for relative to the PHP 'Current Working Directory'. You can find out the location of your Current Working Directory by running the command "echo getcwd()".

  3. Relative Path - Only the file name or partial path is specified (e.g. /myfolder/a.php). In this case, PDT  will search for the file's path in the project's Include Path and in the project itself.
    If the path of the file being searched for exists in more than one location, the file that is called will be the first one PDT encounters during the search process.
    The order in which PDT searches for the file's path is as follows:

    1. The order specified in the "debug target" (the first file to be debugged) project's Include Path. If a project specified in the Include Path refers to other projects/libraries in its own Include Path, the file path will be searched for there before the search process continues.
      See Adding Elements to a Project's Include Path for more on defining the order of projects / libraries in a project's Include Path.

    2. The "debug target" file's project.

See http://il2.php.net/manual/en/function.include.php for more on PHP's search mechanism.

 

 

Related Links

Related Links:
Adding Elements to a Project's Include Path

Path Variables Preferences