| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN"> |
| <html> |
| <head> |
| <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> |
| <meta name="generator" content="Adobe RoboHelp 8"> |
| <title>Configuring a Project's PHP Build Path</title> |
| <link rel="StyleSheet" href="default.css" type="text/css"> |
| <style type="text/css"> |
| <!-- |
| body { border-left-style:None; |
| border-right-style:None; |
| border-bottom-style:None; |
| background-color:Transparent; |
| border-top-style:None; } |
| --> |
| </style> |
| <style type="text/css"> |
| <!-- |
| body { border-left-style:None; |
| border-right-style:None; |
| border-bottom-style:None; |
| background-color:Transparent; |
| border-top-style:None; } |
| --> |
| </style> |
| <script type="text/javascript" language="JavaScript"> |
| //<![CDATA[ |
| function reDo() { |
| if (innerWidth != origWidth || innerHeight != origHeight) |
| location.reload(); |
| } |
| if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) { |
| origWidth = innerWidth; |
| origHeight = innerHeight; |
| onresize = reDo; |
| } |
| onerror = null; |
| //]]> |
| </script> |
| <style type="text/css"> |
| <!-- |
| div.WebHelpPopupMenu { position:absolute; |
| left:0px; |
| top:0px; |
| z-index:4; |
| visibility:hidden; } |
| p.WebHelpNavBar { text-align:right; } |
| --> |
| </style> |
| <script type="text/javascript" language="javascript1.2" src="whmsg.js"></script> |
| <script type="text/javascript" language="javascript" src="whver.js"></script> |
| <script type="text/javascript" language="javascript1.2" src="whproxy.js"></script> |
| <script type="text/javascript" language="javascript1.2" src="whutils.js"></script> |
| <script type="text/javascript" language="javascript1.2" src="whlang.js"></script> |
| <script type="text/javascript" language="javascript1.2" src="whtopic.js"></script> |
| <script type="text/javascript" language="javascript1.2">//<![CDATA[ |
| <!-- |
| if (window.gbWhTopic) |
| { |
| var strUrl = document.location.href; |
| var bc = 0; |
| var n = strUrl.toLowerCase().indexOf("bc-"); |
| if(n != -1) |
| { |
| document.location.href = strUrl.substring(0, n); |
| bc = strUrl.substring(n+3); |
| } |
| |
| if (window.setRelStartPage) |
| { |
| addTocInfo("Tasks\nConfiguring a Project's PHP Build Path"); |
| addAvenueInfo("Tasks","adding_elements_to_a_project_s_include_path.htm","adding_a_server_path_map.htm"); |
| |
| } |
| |
| document.write("<p style=\"text-align:left\"> "); |
| AddMasterBreadcrumbs("ide_help.htm", "", ">", "Home", "pdt_table_of_contents.htm"); |
| document.write("<a href=\"tasks.htm\">Tasks<\/a> > Configuring a Project's PHP Build Path<\/p>"); |
| |
| |
| if (window.setRelStartPage) |
| { |
| setRelStartPage("ide_help.htm"); |
| |
| autoSync(0); |
| sendSyncInfo(); |
| sendAveInfoOut(); |
| } |
| |
| } |
| else |
| if (window.gbIE4) |
| document.location.reload(); |
| //--> |
| //]]></script> |
| </head> |
| |
| <body leftmargin="5" topmargin="5" rightmargin="5" bottommargin="5"><script type="text/javascript" language="javascript1.2">//<![CDATA[ |
| <!-- |
| if (window.writeIntopicBar) |
| writeIntopicBar(4); |
| //--> |
| //]]></script> |
| <div style="width: 100%; position: relative;" id="header"> |
| |
| |
| <p align="right"><a |
| title="Documentation Survey" href="http://spreadsheets.google.com/viewform?formkey=dC1scEswTjFia2tDQ3Y5TVJBbkNQcWc6MQ">Documentation |
| Survey</a> |
| | <a href="javascript:crlf="";h=location.href;t=document.title;e = "" + (window.getSelection ? window.getSelection() : document.getSelection ? document.getSelection() : document.selection.createRange().text); if (e!=null) location="mailto:documentation@zend.com" + "?Subject= Feedback on PDT for page " + escape(t) + "&Body=" + escape(e).replace(/ /g, "+") + crlf + " "; void 0"><span |
| style="background-color: #ffffff;">Submit Documentation</span><span |
| style="background-color: #ffffff;"> Feedback</span></a><span |
| style="background-color: #ffffff;"></span><span style="background-color: #ffffff;"> |
| </span><span style="background-color: #ffffff;">| |
| </span><span |
| style="background-color: #ffffff;"><a title="View Latest Version and Get PDF Online" |
| href="http://www.zend.com/en/resources/zend-documentation/" |
| target="_blank">View Latest |
| Version and Get PDF Online</a></span></p> |
| </div> |
| |
| |
| <h1>Configuring a Project's PHP Build Path |
| </h1> |
| <p>By configuring your project's PHP Build Path, you can select resources |
| which will be included or excluded from the Build process.</p> |
| <p class="Note">Note:</p> |
| <p class="NoteText">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.<br> |
| 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.</p> |
| <p>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.</p> |
| <p class="picture"><img src="build_path_properties.png" alt="build_path_properties.png" style="border: none;" width="297" height="263" border="0"></p> |
| |
| <p>This page allows you to add folders and resources to your Build Path |
| and configure rules for including / excluding certain resources in the |
| project.</p> |
| <p style="font-weight: normal;">You can configure your Build Path according |
| to the options listed below.</p> |
| <p style="font-weight: normal;">Once you have made changes, click OK to |
| save.</p> |
| <p class="Note">Note:</p> |
| <p class="NoteText">By default, all folders which are on your Build Path |
| will be included in your Include Path.</p> |
| <h3><a name="include_exclude_build_path1" id="include_exclude_build_path1"></a>Configuring |
| Inclusion/Exclusion Patterns for the Project</h3> |
| <p>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.</p> |
| <table cellspacing="0" width="100%"> |
| <col style="width: 7.093%;"> |
| <col style="width: 92.907%;"> |
| <tr style="vertical-align: top;"> |
| <td style="width: 7.093%; padding-right: 10px; padding-left: 10px;"><p |
| style="font-size: 6pt;"> </p></td> |
| <td style="width: 92.907%; padding-right: 10px; padding-left: 10px;"><p |
| style="font-weight: bold;"> </p></td> |
| </tr> |
| <tr style="vertical-align: top;"> |
| <td style="width: 7.093%; padding-right: 10px; padding-left: 10px;"><p |
| style="font-size: 6pt;"><img src="ref_icon.png" alt="Instructions on how to complete a procedure" title="Instructions on how to complete a procedure" style="border: none;" width="28" height="33" border="0"></p></td> |
| <td style="width: 92.907%; padding-right: 10px; padding-left: 10px;"><p |
| style="font-weight: bold;">To include/exclude resources from |
| the Build Path:</p> |
| <ol type="1"> |
| <li class="p" style="margin-left: -20px;"><p>In the Build Path |
| Properties page, expand the node next to the folder whose |
| Inclusion/Exclusion pattern you want to configure and click |
| Edit.<br> |
| -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.<br> |
| The Inclusion and Exclusion patterns dialog is displayed.</p></li> |
| </ol> |
| <ol start="2" type="1"> |
| <li class="p" style="margin-left: -20px;"><p>Click Add next |
| to the Inclusion or Exclusion patterns panes.<br> |
| The Add Inclusion/Exclusion Pattern dialog is displayed.</p></li> |
| <li class="p" style="margin-left: -20px;"><p>Enter or select |
| the required resource(s) or pattern to include / exclude and |
| click OK.</p></li> |
| <li class="p" style="margin-left: -20px;"><p>Click Finish.</p></li> |
| </ol></td> |
| </tr> |
| <tr style="vertical-align: top;"> |
| <td colspan="2" style="width: 100%; padding-right: 10px; padding-left: 10px;"><p>All |
| resources in the project which match an inclusion pattern but |
| do not match an exclusion pattern will be added to the Build Path.</p></td> |
| |
| </tr> |
| </table> |
| <h3>Configuring Different Inclusion/Exclusion Patterns for Folders Within |
| your Project</h3> |
| <p>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.</p> |
| <p>Source folders can be created and/or added from the PHP Build Path properties |
| page or from PHP Explorer view.</p> |
| <table cellspacing="0" width="100%"> |
| <col style="width: 7.093%;"> |
| <col style="width: 92.907%;"> |
| <tr style="vertical-align: top;"> |
| <td style="width: 7.093%; padding-right: 10px; padding-left: 10px;"><p |
| style="font-size: 6pt;"> </p></td> |
| <td style="width: 92.907%; padding-right: 10px; padding-left: 10px;"><p |
| style="font-weight: bold;"> </p></td> |
| </tr> |
| <tr style="vertical-align: top;"> |
| <td style="width: 7.093%; padding-right: 10px; padding-left: 10px;"><p |
| style="font-size: 6pt;"><img src="ref_icon.png" alt="Instructions on how to complete a procedure" title="Instructions on how to complete a procedure" style="border: none;" width="28" height="33" border="0"></p></td> |
| <td style="width: 92.907%; padding-right: 10px; padding-left: 10px;"><p |
| style="font-weight: bold;">To add a directory as a separate |
| source folder:</p> |
| <p style="font-weight: normal; text-decoration: underline; ">From |
| the PHP Build Path Properties page:</p> |
| <ol type="1"> |
| <li class="p" style="margin-left: -20px; font-weight: normal;"><p |
| style="font-weight: normal;">Click Add Folder...<br> |
| The Source Folder Selection dialog will display.</p></li> |
| <li class="p" style="margin-left: -20px; font-weight: normal;"><p |
| style="font-weight: normal;">If necessary, click Create |
| New Folder to create a new folder.</p></li> |
| <li class="p" style="margin-left: -20px; font-weight: normal;"><p>Select |
| the required folder and click OK.</p></li> |
| <li class="p" style="margin-left: -20px; font-weight: normal;"><p>The |
| folder will be added as a separate source folder in the Build |
| Path list.</p></li> |
| </ol> |
| <p class="Note">Note:</p> |
| <p class="NoteText">In order to overcome the nesting conflict, |
|  you should exclude the folder you have just added from the |
| parent folder's Build Path. See '<a href="#include_exclude_build_path1">Configuring |
| Inclusion/Exclusion Patterns</a>', above, for information on how |
| to exclude the folder and all resources contained within it.</p> |
| <p class="picture"><img src="build_path_add_source_folder.png" alt="build_path_add_source_folder.png" style="border: none;" width="363" height="228" border="0"></p> |
| |
| <p style="font-weight: normal; text-decoration: underline; ">From |
| PHP Explorer view:</p> |
| <ol type="1"> |
| <li class="p" style="margin-left: -20px; font-weight: normal;"><p>Right-click |
| the project and select Build Path | New Source Folder.<br> |
| The New Source Folder dialog will be displayed.</p></li> |
| </ol> |
| <p class="picture"><img src="build_path_new_source_folder.png" alt="build_path_new_source_folder.png" style="border: none;" width="350" height="208" border="0"></p> |
| |
| |
| <ol start="2" type="1"> |
| <li class="p" style="margin-left: -20px;"><p>Enter the name |
| for the new folder in the Folder name field.</p></li> |
| <li class="p" style="margin-left: -20px;"><p>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.<br> |
| In order to avoid these nesting conflicts, select one of the |
| following options:</p></li> |
| </ol> |
| <ul type="square"> |
| <li><p>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.</p></li> |
| <li><p>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.</p></li> |
| </ul> |
| <ol start="4" type="1"> |
| <li class="p" style="margin-left: -20px;"><p>Click Finish.</p></li> |
| </ol></td> |
| </tr> |
| <tr style="vertical-align: top;"> |
| <td colspan="2" style="width: 100%; padding-right: 10px; padding-left: 10px;"><p>You |
| can now configure a pattern for including/excluding resources |
| for the source folder by following the instructions under '<a |
| href="#include_exclude_build_path1">Configuring Inclusion/Exclusion |
| Patterns</a>', above.</p></td> |
| |
| </tr> |
| </table> |
| <h3>Adding External Source Folders to the Build Path</h3> |
| <p>You can add an external source folder as a link to your project which |
| will be scanned during the Build process.</p> |
| <table cellspacing="0" width="100%"> |
| <col style="width: 7.093%;"> |
| <col style="width: 92.907%;"> |
| <tr style="vertical-align: top;"> |
| <td style="width: 7.093%; padding-right: 10px; padding-left: 10px;"><p |
| style="font-size: 6pt;"> </p></td> |
| <td style="width: 92.907%; padding-right: 10px; padding-left: 10px;"><p |
| style="font-weight: bold;"> </p></td> |
| </tr> |
| <tr style="vertical-align: top;"> |
| <td style="width: 7.093%; padding-right: 10px; padding-left: 10px;"><p |
| style="font-size: 6pt;"><img src="ref_icon.png" alt="Instructions on how to complete a procedure" title="Instructions on how to complete a procedure" style="border: none;" width="28" height="33" border="0"></p></td> |
| <td style="width: 92.907%; padding-right: 10px; padding-left: 10px;"><p |
| style="font-weight: bold;">To add an external source folder |
| to the project's Build Path:</p> |
| <ol type="1"> |
| <li class="p" style="margin-left: -20px; font-weight: normal;"><p>In |
| the Build Path Properties page, click the 'Link Source...' |
| button.<br> |
| -Or- In PHP Explorer view, right-click the project and select |
| Build Path | Link Source.<br> |
| The Link Source dialog is displayed.</p></li> |
| </ol> |
| <p class="picture"><img src="build_path_link_source.png" alt="build_path_link_source.png" style="border: none;" width="350" height="253" border="0"></p> |
| |
| |
| <ol start="2" type="1"> |
| <li style="margin-left: -20px; font-family: Arial, sans-serif;">Click |
| the 'Browse..' button and browse to the location of the folder |
| you want to add to the Build Path.<br> |
| Alternately, click Variables and select the variable which |
| points to the required resource.</li> |
| <li style="margin-left: -20px; font-family: Arial, sans-serif;">The |
| Folder name field will have been automatically populated with |
| the name of the original folder.<br> |
| Edit this entry if required.</li> |
| <li style="margin-left: -20px; font-family: Arial, sans-serif;">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.<br> |
| In order to avoid these nesting conflicts, select one of the |
| following options:</li> |
| </ol> |
| <ul type="square"> |
| <li><p>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.</p></li> |
| <li><p>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.</p></li> |
| <li><p>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.</p></li> |
| </ul> |
| <ol start="5" type="1"> |
| <li class="p" style="margin-left: -20px;"><p>Click Finish.</p></li> |
| </ol></td> |
| </tr> |
| <tr style="vertical-align: top;"> |
| <td colspan="2" style="width: 100%; padding-right: 10px; padding-left: 10px;"><p>The |
| folder will be added to your Build Path and displayed in the Build |
| Path list.</p> |
| <p style="font-weight: normal;">You can now configure a pattern |
| for including/excluding resources for the linked folder by following |
| the instructions under '<a href="#include_exclude_build_path1">Configuring |
| Inclusion/Exclusion Patterns</a>', above.</p></td> |
| |
| </tr> |
| </table> |
| <table cellspacing="0" width="100%"> |
| <col style="width: 7.093%;"> |
| <col style="width: 92.907%;"> |
| <tr style="vertical-align: top; |
| height: 16px;"> |
| <td style="width: 7.093%; padding-right: 10px; |
| padding-left: 10px;"><p |
| style="font-size: 6pt;"> </p></td> |
| <td style="width: 92.907%; |
| padding-right: 10px; padding-left: 10px;"><p> </p></td> |
| </tr> |
| <tr style="vertical-align: top; |
| height: 35px;"> |
| <td style="width: 7.093%; padding-right: 10px; |
| padding-left: 10px;"><p |
| style="font-size: 6pt;"><img src="link_icon.png" alt="link_icon.png" style="border: none;" width="32" height="40" border="0"> </p></td> |
| <td style="width: 92.907%; |
| padding-right: 10px; padding-left: 10px;"><p><span |
| style="font-weight: bold;"><b>Related Links:</b></span><a href="adding_elements_to_a_project_s_include_path.htm"><br> |
| Configuring a Project's Include Path</a></p></td> |
| </tr> |
| <tr style="vertical-align: top; |
| height: 19px;"> |
| <td style="width: 7.093%; padding-right: 10px; |
| padding-left: 10px;"><p |
| style="font-size: 6pt;"> </p></td> |
| <td style="width: 92.907%; |
| padding-right: 10px; padding-left: 10px;"><p> </p></td> |
| </tr> |
| </table> |
| <div style="width: 100%; position: relative;" id="footer"> |
| |
| <p style="text-decoration: underline; " |
| align="center">PHP Development |
| Tools</p> |
| |
| |
| </div> |
| <script type="text/javascript" language="javascript1.2">//<![CDATA[ |
| <!-- |
| if (window.writeIntopicBar) |
| writeIntopicBar(0); |
| |
| highlightSearch(); |
| //--> |
| //]]></script> |
| </body> |
| </html> |
