You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@netbeans.apache.org by vi...@apache.org on 2020/01/16 17:44:41 UTC
[netbeans-website] branch master updated: [NETBEANS-1870] Reviewing
the Asciidoc of PHP tutorials (#434)
This is an automated email from the ASF dual-hosted git repository.
vieiro pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/netbeans-website.git
The following commit(s) were added to refs/heads/master by this push:
new af42c7a [NETBEANS-1870] Reviewing the Asciidoc of PHP tutorials (#434)
af42c7a is described below
commit af42c7a58634c1c0fe2508f7cbf117add714049b
Author: Antonio Vieiro <vi...@users.noreply.github.com>
AuthorDate: Thu Jan 16 18:44:33 2020 +0100
[NETBEANS-1870] Reviewing the Asciidoc of PHP tutorials (#434)
* [kb/docs/php] Set 1
* [php] wishlist-lesson3
---
.../content/kb/docs/php/ajax-quickstart.asciidoc | 147 +++++++++----
.../kb/docs/php/ajax-quickstart_ja.asciidoc | 146 ++++++++----
.../kb/docs/php/ajax-quickstart_pt_BR.asciidoc | 161 +++++++++-----
.../kb/docs/php/ajax-quickstart_ru.asciidoc | 157 +++++++++----
.../kb/docs/php/ajax-quickstart_zh_CN.asciidoc | 146 ++++++++----
.../content/kb/docs/php/code-templates.asciidoc | 141 +++++++++---
.../content/kb/docs/php/code-templates_ja.asciidoc | 130 ++++++++---
.../kb/docs/php/code-templates_pt_BR.asciidoc | 127 ++++++++---
.../content/kb/docs/php/code-templates_ru.asciidoc | 125 ++++++++---
.../kb/docs/php/code-templates_zh_CN.asciidoc | 130 ++++++++---
.../php/configure-php-environment-mac-os.asciidoc | 25 ++-
.../configure-php-environment-mac-os_ja.asciidoc | 76 +++++--
...configure-php-environment-mac-os_pt_BR.asciidoc | 75 +++++--
.../configure-php-environment-mac-os_ru.asciidoc | 76 +++++--
...configure-php-environment-mac-os_zh_CN.asciidoc | 72 ++++--
.../php/configure-php-environment-ubuntu.asciidoc | 26 +--
.../configure-php-environment-ubuntu_ja.asciidoc | 98 ++++++---
...configure-php-environment-ubuntu_pt_BR.asciidoc | 98 ++++++---
.../configure-php-environment-ubuntu_ru.asciidoc | 98 ++++++---
...configure-php-environment-ubuntu_zh_CN.asciidoc | 95 +++++---
.../php/configure-php-environment-windows.asciidoc | 37 ++--
.../configure-php-environment-windows_ja.asciidoc | 114 +++++++---
...onfigure-php-environment-windows_pt_BR.asciidoc | 110 ++++++---
.../configure-php-environment-windows_ru.asciidoc | 114 +++++++---
...onfigure-php-environment-windows_zh_CN.asciidoc | 114 +++++++---
.../src/content/kb/docs/php/debugging.asciidoc | 240 +++++++++++++++-----
.../src/content/kb/docs/php/debugging_ja.asciidoc | 245 +++++++++++++++------
.../content/kb/docs/php/debugging_pt_BR.asciidoc | 202 ++++++++++++-----
.../src/content/kb/docs/php/debugging_ru.asciidoc | 208 ++++++++++++-----
.../content/kb/docs/php/debugging_zh_CN.asciidoc | 201 ++++++++++++-----
.../src/content/kb/docs/php/phpunit.asciidoc | 120 +++++++---
.../src/content/kb/docs/php/phpunit_ja.asciidoc | 134 ++++++++---
.../src/content/kb/docs/php/phpunit_pt_BR.asciidoc | 134 ++++++++---
.../src/content/kb/docs/php/phpunit_ru.asciidoc | 140 +++++++++---
.../src/content/kb/docs/php/phpunit_zh_CN.asciidoc | 134 ++++++++---
.../src/content/kb/docs/php/project-setup.asciidoc | 49 +++--
.../content/kb/docs/php/project-setup_ja.asciidoc | 120 +++++++---
.../kb/docs/php/project-setup_pt_BR.asciidoc | 119 +++++++---
.../content/kb/docs/php/project-setup_ru.asciidoc | 128 ++++++++---
.../kb/docs/php/project-setup_zh_CN.asciidoc | 119 +++++++---
.../src/content/kb/docs/php/quickstart.asciidoc | 16 +-
.../src/content/kb/docs/php/quickstart_ja.asciidoc | 52 +++--
.../content/kb/docs/php/quickstart_pt_BR.asciidoc | 50 +++--
.../content/kb/docs/php/quickstart_zh_CN.asciidoc | 50 +++--
.../php/remote-hosting-and-ftp-account.asciidoc | 52 ++++-
.../php/remote-hosting-and-ftp-account_ja.asciidoc | 56 ++++-
.../remote-hosting-and-ftp-account_pt_BR.asciidoc | 54 ++++-
.../php/remote-hosting-and-ftp-account_ru.asciidoc | 55 ++++-
.../remote-hosting-and-ftp-account_zh_CN.asciidoc | 57 +++--
.../content/kb/docs/php/wish-list-lesson1.asciidoc | 157 +++++++------
.../kb/docs/php/wish-list-lesson1_ja.asciidoc | 139 +++++++-----
.../kb/docs/php/wish-list-lesson1_pt_BR.asciidoc | 147 +++++++------
.../kb/docs/php/wish-list-lesson1_ru.asciidoc | 139 +++++++-----
.../kb/docs/php/wish-list-lesson1_zh_CN.asciidoc | 148 +++++++------
.../content/kb/docs/php/wish-list-lesson2.asciidoc | 232 ++++++++++---------
.../kb/docs/php/wish-list-lesson2_ja.asciidoc | 235 +++++++++++---------
.../kb/docs/php/wish-list-lesson2_pt_BR.asciidoc | 195 ++++++++--------
.../kb/docs/php/wish-list-lesson2_ru.asciidoc | 234 +++++++++++---------
.../kb/docs/php/wish-list-lesson2_zh_CN.asciidoc | 229 ++++++++++---------
.../content/kb/docs/php/wish-list-lesson3.asciidoc | 169 +++++++-------
.../kb/docs/php/wish-list-lesson3_ja.asciidoc | 134 +++++------
.../kb/docs/php/wish-list-lesson3_pt_BR.asciidoc | 135 ++++++------
.../kb/docs/php/wish-list-lesson3_ru.asciidoc | 127 +++++------
.../kb/docs/php/wish-list-lesson3_zh_CN.asciidoc | 127 +++++------
64 files changed, 5235 insertions(+), 2685 deletions(-)
diff --git a/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart.asciidoc
index 878639e..48f13c1 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart.asciidoc
@@ -79,21 +79,29 @@ Begin by creating a new PHP application project in the IDE.
1. Choose File > New Project. Under Categories, select *PHP*. Under Projects, select *PHP Application* then click *Next*.
2. In Step 2: Name and Location, name the project `MyAjaxApp`. The Sources Folder field enables you to specify the location of the project on your computer. Leave other options at their defaults and click *Next*.
+
image::images/php-name-location.png[title="New PHP Project wizard - Name and Location panel"]
-3. In Step 3: Run Configuration, specify how you want to deploy your application. If you have set up your PHP development environment by configuring an *AMP package, you should select *Local Web Site* from the drop-down list, and specify the URL of the project, as it will appear in a browser.
-4. Select the Copy files from Sources Folder to another location option. Then, in the Copy to Folder field, type in the path to the deployment location on the server. (On Apache, this is the default `htdocs` directory.)
+
+[start=3]
+. In Step 3: Run Configuration, specify how you want to deploy your application. If you have set up your PHP development environment by configuring an *AMP package, you should select *Local Web Site* from the drop-down list, and specify the URL of the project, as it will appear in a browser.
+. Select the Copy files from Sources Folder to another location option. Then, in the Copy to Folder field, type in the path to the deployment location on the server. (On Apache, this is the default `htdocs` directory.)
+
[.feature]
--
image::images/php-run-config.png[role="left", link="images/php-run-config.png"]
--
-5. Click *Finish*. The IDE creates the project folder in your file system and the project opens in the IDE.
+
+[start=5]
+. Click *Finish*. The IDE creates the project folder in your file system and the project opens in the IDE.
You can also use the Project wizard to add framework support to your project (provided in Step 4 of the wizard).
A default `index.php` index page is generated and opens in the IDE's editor. Also, your project appears in the Projects window.
image::images/php-proj-win.png[title="Projects window displays MyAjaxApp project"]
-6. Before beginning to code, quickly try running the application to ensure that configuration between the IDE, your server, and browser is set up properly.
+
+[start=6]
+. Before beginning to code, quickly try running the application to ensure that configuration between the IDE, your server, and browser is set up properly.
In the IDE's editor, add an `echo` statement to the index page:
@@ -106,7 +114,9 @@ In the IDE's editor, add an `echo` statement to the index page:
?>
----
-7. In the Projects window, right-click on the project node and choose Run. The IDE opens your default browser and displays the Hello World message you just created in `index.php`.
+
+[start=7]
+. In the Projects window, right-click on the project node and choose Run. The IDE opens your default browser and displays the Hello World message you just created in `index.php`.
NOTE: If you have difficulty setting up your project or establishing communication between the IDE, the server and browser, see link:project-setup.html[+Setting Up a PHP Project+] for a more thorough description. The link:../../trails/php.html[+PHP Learning Trail+] can provide more information on configuring your environment.
@@ -129,7 +139,7 @@ You can view large icons (as displayed here) by right-clicking in the Palette an
2. In the HTML File wizard, name the file `index`, then click *Finish*. The new `index.html` file opens in the editor.
3. Replace the existing content for the file as follows.
-[source,xml]
+[source,html]
----
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
@@ -146,7 +156,9 @@ You can view large icons (as displayed here) by right-clicking in the Palette an
</html>
----
-4. Add some explanatory text to describe the purpose of the text field. You can copy and paste in the following text at a point just beneath the `<h1>` tags:
+
+[start=4]
+. Add some explanatory text to describe the purpose of the text field. You can copy and paste in the following text at a point just beneath the `<h1>` tags:
[source,html]
----
@@ -159,16 +171,21 @@ You can view large icons (as displayed here) by right-clicking in the Palette an
then click on one of the selections to see composer details.</p>
----
-5. Add an HTML form to the page. You can do this by making use of the elements listed in the IDE's Palette. If the Palette is not open, choose Window > Palette from the main menu. Then, under HTML Forms, click on and drag a Form element into the page to a point beneath the `<p>` tags that you just added. The Insert Form dialog box opens. Specify the following:
+
+[start=5]
+. Add an HTML form to the page. You can do this by making use of the elements listed in the IDE's Palette. If the Palette is not open, choose Window > Palette from the main menu. Then, under HTML Forms, click on and drag a Form element into the page to a point beneath the `<p>` tags that you just added. The Insert Form dialog box opens. Specify the following:
* Action: autocomplete.php
* Method: GET
* Name: autofillform
+
image::images/php-insert-form.png[title="Insert form dialog"]
Click OK. The HTML `<form>` tags are inserted into the page containing the attributes you specified. (GET is applied by default, and so is not explicitly declared.)
-6. Add an HTML table to the page. Under the HTML category in the Palette, click on a Table element and drag it to a point between the `<form>` tags. The Insert Table dialog box opens. Specify the following:
+
+[start=6]
+. Add an HTML table to the page. Under the HTML category in the Palette, click on a Table element and drag it to a point between the `<form>` tags. The Insert Table dialog box opens. Specify the following:
* Rows: 2
* Columns: 2
@@ -176,10 +193,13 @@ Click OK. The HTML `<form>` tags are inserted into the page containing the attri
* Width: 0
* Cell Spacing: 0
* Cell Padding: 5
+
image::images/insert-table.png[title="Insert table dialog"]
-7. Right-click inside the Source Editor and choose Format. This tidies up the code. Your form should now display similar to that below:
-[source,xml]
+[start=7]
+. Right-click inside the Source Editor and choose Format. This tidies up the code. Your form should now display similar to that below:
+
+[source,html]
----
<form name="autofillform" action="autocomplete.php">
@@ -204,16 +224,20 @@ image::images/insert-table.png[title="Insert table dialog"]
</form>
----
-8. Within the first row of the table, type the following text into the first column (changes in *bold*):
-[source,xml]
+[start=8]
+. Within the first row of the table, type the following text into the first column (changes in *bold*):
+
+[source,html]
----
<td>*<strong>Composer Name:</strong>*</td>
----
-9. Within the second column of the first row, instead of dragging a Text Input field from the Palette, type in the code below manually.
-[source,java]
+[start=9]
+. Within the second column of the first row, instead of dragging a Text Input field from the Palette, type in the code below manually.
+
+[source,html]
----
<input type="text"
@@ -223,14 +247,20 @@ image::images/insert-table.png[title="Insert table dialog"]
----
When you type, try using the IDE's built-in code completion support. For example, type in `<i`, then press Ctrl-Space. A list of suggested options displays below your cursor, and a description of the selected element appears in a box above. You can in fact press Ctrl-Space at anytime you are coding in the Source Editor to bring up possible options. Also, if there is only one possible option, pressing Ctrl-Space will automatically complete the element name.
-image::images/code-completion.png[title="Ctrl-Space triggers code completion in the Source Editor"]
+image:images/code-completion.png[title="Ctrl-Space triggers code completion in the Source Editor"]
The `onkeyup` attribute that you typed in above points to a JavaScript function named `doCompletion()`. This function is called each time a key is pressed in the form text field, and maps to the JavaScript call depicted in the Ajax <<flow-diagram,flow diagram>> above.
-10. Before moving on to work in the JavaScript editor, make the new `index.html` file replace the `index.php` file as the entry point for the application.
-To do so, right-click the project node in the Projects window and choose Properties. Select the *Run Configuration* category, then enter `index.html` in the Index File field. image::images/php-entry-point.png[title="Specify the application's entry point in the Project Properties window"]
-11. Click OK to save changes and exit the Project Properties window.
-12. Run the project to see what it looks like in a browser. Click the Run Project ( image::images/run-project-btn.png[] ) button. The `index.html` file displays in your default browser.
-image::images/index-page.png[title="Run project to view its current state in browser"]
+[start=10]
+. Before moving on to work in the JavaScript editor, make the new `index.html` file replace the `index.php` file as the entry point for the application.
+
+To do so, right-click the project node in the Projects window and choose Properties. Select the *Run Configuration* category, then enter `index.html` in the Index File field. image:images/php-entry-point.png[title="Specify the application's entry point in the Project Properties window"]
+
+[start=11]
+. Click OK to save changes and exit the Project Properties window.
+
+[start=12]
+. Run the project to see what it looks like in a browser. Click the Run Project ( image:images/run-project-btn.png[] ) button. The `index.html` file displays in your default browser.
+image:images/index-page.png[title="Run project to view its current state in browser"]
[[javascript]]
@@ -250,7 +280,7 @@ Add a JavaScript file to the application and begin implementing `doCompletion()`
2. Name the file `javascript`, then click Finish. The new JavaScript file appears in the Projects window and opens in the editor.
3. Type the code below into `javascript.js`.
-[source,java]
+[source,php]
----
var req;
@@ -284,9 +314,11 @@ function initRequest() {
The above code performs a simple browser compatibility check for Firefox 3 and Internet Explorer versions 6 and 7). If you would like to incorporate more robust code for compatibility issues, consider using this link:http://www.quirksmode.org/js/detect.html[+browser detect script+] from link:http://www.quirksmode.org[+http://www.quirksmode.org+].
-4. Switch back to `index.html` and add a reference to the JavaScript file between the `<head>` tags.
-[source,xml]
+[start=4]
+. Switch back to `index.html` and add a reference to the JavaScript file between the `<head>` tags.
+
+[source,html]
----
<script type="text/javascript" src="javascript.js"></script>
@@ -295,9 +327,11 @@ The above code performs a simple browser compatibility check for Firefox 3 and I
You can quickly toggle between pages opened in the editor by pressing Ctrl-Tab.
-5. Insert a call to `init()` in the opening `<body>` tag.
-[source,java]
+[start=5]
+. Insert a call to `init()` in the opening `<body>` tag.
+
+[source,html]
----
<body *onload="init()"*>
@@ -319,7 +353,7 @@ Three parameters are specified when you create an `XMLHttpRequest` object: a URL
* The URL `autocomplete.php`, and the text entered into the `complete-field` by the user:
-[source,java]
+[source,php]
----
var url = "autocomplete.php?action=complete&id=" + escape(completeField.value);
@@ -327,7 +361,7 @@ var url = "autocomplete.php?action=complete&id=" + escape(completeField.valu
* `GET`, signifying that HTTP interactions use the `GET` method, and
* `true`, signifying that the interaction is asynchronous:
-[source,java]
+[source,php]
----
req.open("GET", url, true);
@@ -336,7 +370,7 @@ req.open("GET", url, true);
If the interaction is set as asynchronous, a callback function must be specified. The callback function for this interaction is set with the statement:
-[source,java]
+[source,php]
----
req.onreadystatechange = callback;
@@ -408,7 +442,9 @@ class ComposerData {
}
----
-4. In the editor, paste in the following code within the class (changes in *bold*).
+
+[start=4]
+. In the editor, paste in the following code within the class (changes in *bold*).
[source,php]
----
@@ -492,9 +528,13 @@ class ComposerData {
Implement the logic to handle the `autocomplete` URL that is received by the incoming request. Instead of creating a new PHP file using the File wizard as demonstrated in the previous section, modify the existing `index.php` file for this purpose.
1. In the Projects window, click the `index.php` file node. The file name becomes editable, enabling you to modify the name.
-image::images/edit-file-name.png[title="Click on file nodes to edit names"]
-2. Name the file `autocomplete`, then click Enter. Double-click the new `autocomplete.php` file to have it display in the editor.
-3. Replace the file's existing code with the following script.
+image:images/edit-file-name.png[title="Click on file nodes to edit names"]
+
+[start=2]
+. Name the file `autocomplete`, then click Enter. Double-click the new `autocomplete.php` file to have it display in the editor.
+
+[start=3]
+. Replace the file's existing code with the following script.
[source,php]
----
@@ -666,7 +706,10 @@ NOTE: The functions and elements that you create in the following steps work int
</tr>
----
This new row, which can be identified as '`auto-row`', serves as a handle for the JavaScript code in order to insert a new HTML table that will form the auto-complete box.
-2. Open `javascript.js` in the editor and the following three variables to the top of the file.
+
+
+[start=2]
+. Open `javascript.js` in the editor and the following three variables to the top of the file.
[source,java]
----
@@ -675,7 +718,9 @@ var completeField;
var completeTable;
var autoRow;
----
-3. Add the following lines (in *bold*) to the `init()` function.
+
+[start=3]
+. Add the following lines (in *bold*) to the `init()` function.
[source,java]
----
@@ -701,7 +746,9 @@ One purpose of `init()` is to make elements inside `index.html` accessible to ot
<td/>
</tr>
----
-4. Add `appendComposer()` to `javascript.js`.
+
+[start=4]
+. Add `appendComposer()` to `javascript.js`.
[source,java]
----
@@ -734,7 +781,9 @@ function appendComposer(firstName,lastName,composerId) {
}
----
This function creates a new table row, inserts a link to a composer into it using the data passed to the function via its three parameters, and inserts the row into the index page's `complete-table` element.
-5. Add `clearTable()` to `javascript.js`.
+
+[start=5]
+. Add `clearTable()` to `javascript.js`.
[source,java]
----
@@ -749,7 +798,9 @@ function clearTable() {
}
----
This function sets the display of the `complete-table` element to 'none', (i.e., makes it invisible), and it removes any existing composer name entries that were created.
-6. Add `getElementY()` to `javascript.js`.
+
+[start=6]
+. Add `getElementY()` to `javascript.js`.
[source,java]
----
@@ -773,7 +824,8 @@ This function is applied to find the vertical position of the parent element. Th
NOTE: See link:http://www.quirksmode.org/js/findpos.html[+this explanation+] of `offset` on link:http://www.quirksmode.org/[+http://www.quirksmode.org/+].
-7. Modify the `callback()` function to call `clearTable()` each time new data is received from the server. Any composer entries that already exist in the auto-complete box are therefore removed before it becomes populated with new entries.
+[start=7]
+. Modify the `callback()` function to call `clearTable()` each time new data is received from the server. Any composer entries that already exist in the auto-complete box are therefore removed before it becomes populated with new entries.
[source,java]
----
@@ -789,7 +841,9 @@ function callback() {
}
}
----
-8. Add `parseMessages()` to `javascript.js`.
+
+[start=8]
+. Add `parseMessages()` to `javascript.js`.
[source,java]
----
@@ -843,14 +897,14 @@ The dynamic update to the `complete-table` element represents the final step of
At this stage, you have completed all the code needed for the functionality of the application. To see the results of your efforts, try running the application now.
-1. Run the project to see what it looks like in a browser. Click the Run Project ( image::images/run-project-btn.png[] ) button. The `index.html` file displays in your browser.
-image::images/no-css.png[title="Successful deployment without stylesheet"]
+1. Run the project to see what it looks like in a browser. Click the Run Project ( image:images/run-project-btn.png[] ) button. The `index.html` file displays in your browser.
+image:images/no-css.png[title="Successful deployment without stylesheet"]
To attach a stylesheet to your application, simply create a CSS (Cascading Style Sheets) file and link to it from your presentation page(s). When you work in CSS files, the IDE provides you with code completion support, as well as several other features that can aid in producing stylesheet rules. These include:
* *CSS Style Builder:* An interface designed to enable you to create rules using a selection of controls and widgets. (Window > Other > CSS Style Builder)
* *CSS Preview:* A preview window which, when you place your cursor within a rule, displays sample text rendered according to the declaration block of that rule. (Window > Other > CSS Preview)
-* *Style Rule Editor:* A dialog enabling you to create rules based on classes, ID's and HTML elements, and set their position in the document hierarchy. (Create Rule ( image::images/style-rule-editor-btn.png[] ) button, located in upper-left region of CSS editor toolbar)
+* *Style Rule Editor:* A dialog enabling you to create rules based on classes, ID's and HTML elements, and set their position in the document hierarchy. (Create Rule ( image:images/style-rule-editor-btn.png[] ) button, located in upper-left region of CSS editor toolbar)
NetBeans 6.9 provides Rename Refactoring and Find Usages support. This support is available not only in css files, but in all files containing embedded CSS code (e.g., HTML, PHP). CSS classes, id's and type elements can be refactored in all project files. To make use of this refactoring support, press Ctrl-R on a given CSS element and use the provided dialog to perform the rename action. You can also preview changes before performing the rename action. To utilize Find Usages support, rig [...]
@@ -930,7 +984,8 @@ a:hover {
Perform a check on the validity of your CSS code by right-clicking in the CSS Editor and choosing Check CSS. Any errors encountered are displayed in the Output window (Windows > Output).
-5. Switch to the `index.html` page in the editor (press Ctrl-Tab), and add a reference to the stylesheet between the `<head>` tags.
+[start=5]
+. Switch to the `index.html` page in the editor (press Ctrl-Tab), and add a reference to the stylesheet between the `<head>` tags.
[source,java]
----
@@ -938,7 +993,9 @@ Perform a check on the validity of your CSS code by right-clicking in the CSS Ed
<link rel="stylesheet" type="text/css" href="stylesheet.css">
----
-6. Run the application again. The index page displays in the browser using the stylesheet you just created. Each time you type in a character, an asynchronous request is sent to the server, and returned with XML data that has been prepared by `autocomplete.php`. As you enter more characters, the number of composer names decreases to reflect the new list of matches.
+
+[start=6]
+. Run the application again. The index page displays in the browser using the stylesheet you just created. Each time you type in a character, an asynchronous request is sent to the server, and returned with XML data that has been prepared by `autocomplete.php`. As you enter more characters, the number of composer names decreases to reflect the new list of matches.
diff --git a/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart_ja.asciidoc
index c122ef3..f5b17cb 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart_ja.asciidoc
@@ -89,21 +89,30 @@ image::images/ajax-process-flow.png[title="Ajaxのプロセス・フロー図"]
1. 「ファイル」>「新規プロジェクト」を選択します。「カテゴリ」から「*PHP*」を選択します。「プロジェクト」で「*PHPアプリケーション*」を選択し、「*次*」をクリックします。
2. ステップ2の「名前と場所」で、プロジェクト名に「`MyAjaxApp`」と入力します。「ソース・フォルダ」フィールドでコンピュータ上でのプロジェクトの場所を指定できます。他のオプションはデフォルトのままにして、「*次*」をクリックします。
+
image::images/php-name-location.png[title="新規PHPプロジェクト・ウィザード - 「名前と場所」パネル"]
-3. ステップ3の「実行構成」で、アプリケーションのデプロイ方法を指定します。*AMPパッケージを構成してPHP開発環境を設定した場合は、ドロップダウン・リストから「*ローカルWebサイト*」を選択し、ブラウザに表示するプロジェクトのURLを指定します。
-4. 「ファイルをソース・フォルダから別の場所にコピー」オプションを選択します。次に、「フォルダにコピー」フィールドに、サーバー上のデプロイ先のパスを入力します。(Apacheでは、デフォルトの`htdocs`ディレクトリを使用します。)
+
+[start=3]
+. ステップ3の「実行構成」で、アプリケーションのデプロイ方法を指定します。*AMPパッケージを構成してPHP開発環境を設定した場合は、ドロップダウン・リストから「*ローカルWebサイト*」を選択し、ブラウザに表示するプロジェクトのURLを指定します。
+
+[start=4]
+. 「ファイルをソース・フォルダから別の場所にコピー」オプションを選択します。次に、「フォルダにコピー」フィールドに、サーバー上のデプロイ先のパスを入力します。(Apacheでは、デフォルトの`htdocs`ディレクトリを使用します。)
[.feature]
--
image:images/php-run-config.png[role="left", link="images/php-run-config.png"]
--
-5. 「*終了*」をクリックします。IDEによってプロジェクト・フォルダがファイル・システム内に作成され、プロジェクトがIDEで開きます。
+
+[start=5]
+. 「*終了*」をクリックします。IDEによってプロジェクト・フォルダがファイル・システム内に作成され、プロジェクトがIDEで開きます。
プロジェクト・ウィザードを使用して、 フレームワークのサポートをプロジェクトに追加することもできます(ウィザードのステップ4)。
デフォルトの`index.php`インデックス・ページが生成され、IDEのエディタで開きます。また、「プロジェクト」ウィンドウにプロジェクトが表示されます。
image::images/php-proj-win.png[title="MyAjaxAppプロジェクトが表示された「プロジェクト」ウィンドウ"]
-6. コーディングを始める前に、アプリケーションを実行してみて、IDE、サーバー、ブラウザの間の構成が正しく設定されていることを確認します。
+
+[start=6]
+. コーディングを始める前に、アプリケーションを実行してみて、IDE、サーバー、ブラウザの間の構成が正しく設定されていることを確認します。
IDEのエディタで、indexページに次の`echo`文を追加します。
@@ -116,7 +125,9 @@ IDEのエディタで、indexページに次の`echo`文を追加します。
?>
----
-7. 「プロジェクト」ウィンドウでプロジェクト・ノードを右クリックし、「実行」を選択します。IDEによってデフォルトのブラウザが開き、`index.php`で作成したメッセージ「Hello World」が表示されます。
+
+[start=7]
+. 「プロジェクト」ウィンドウでプロジェクト・ノードを右クリックし、「実行」を選択します。IDEによってデフォルトのブラウザが開き、`index.php`で作成したメッセージ「Hello World」が表示されます。
*注意:* プロジェクトを設定できない場合、またはIDE、サーバー、およびブラウザ間で通信を確立できない場合は、link:project-setup.html[+PHPプロジェクトの設定+]を参照して、詳細な手順を確認してください。環境の構成については、link:../../trails/php.html[+PHPの学習+]を参照してください。
@@ -139,7 +150,7 @@ IDEのパレットも便利な機能です。パレットには、コーディ
2. HTMLファイル・ウィザードで、ファイル名に「`index`」と入力し、「*終了*」をクリックします。新しい`index.html`ファイルがエディタで開きます。
3. このファイルの既存の内容を次の内容に置き換えます。
-[source,xml]
+[source,html]
----
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
@@ -156,7 +167,9 @@ IDEのパレットも便利な機能です。パレットには、コーディ
</html>
----
-4. テキスト・フィールドの目的を説明するテキストを追加します。次のテキストをコピーして、`<h1>`タグのすぐ下に貼り付けることもできます。
+
+[start=4]
+. テキスト・フィールドの目的を説明するテキストを追加します。次のテキストをコピーして、`<h1>`タグのすぐ下に貼り付けることもできます。
[source,html]
----
@@ -169,16 +182,21 @@ IDEのパレットも便利な機能です。パレットには、コーディ
then click on one of the selections to see composer details.</p>
----
-5. ページにHTMLフォームを追加します。この操作を行うには、IDEのパレットに表示されている要素を使用します。パレットが開いていない場合は、メイン・メニューから「ウィンドウ」>「パレット」を選択します。次に「HTMLフォーム」の下にある「フォーム」要素をクリックし、ページ内に追加した`<p>`タグの下までドラッグします。「挿入フォーム」ダイアログ・ボックスが表示されます。次の値を指定します。
+
+[start=5]
+. ページにHTMLフォームを追加します。この操作を行うには、IDEのパレットに表示されている要素を使用します。パレットが開いていない場合は、メイン・メニューから「ウィンドウ」>「パレット」を選択します。次に「HTMLフォーム」の下にある「フォーム」要素をクリックし、ページ内に追加した`<p>`タグの下までドラッグします。「挿入フォーム」ダイアログ・ボックスが表示されます。次の値を指定します。
* アクション: autocomplete.php
* メソッド: GET
* 名前: autofillform
+
image::images/php-insert-form.png[title="「挿入フォーム」ダイアログ"]
「OK」をクリックします。指定した属性を含むHTMLの`<form>`タグがページに挿入されます。(GETはデフォルトで適用されるので、明示的に宣言しません。)
-6. HTML表をページに追加します。パレットの「HTML」カテゴリの下で「表」要素をクリックし、`<form>`タグの間の位置までドラッグします。「挿入表」ダイアログ・ボックスが開きます。次の値を指定します。
+
+[start=6]
+. HTML表をページに追加します。パレットの「HTML」カテゴリの下で「表」要素をクリックし、`<form>`タグの間の位置までドラッグします。「挿入表」ダイアログ・ボックスが開きます。次の値を指定します。
* 行: 2
* 列: 2
@@ -186,10 +204,13 @@ image::images/php-insert-form.png[title="「挿入フォーム」ダイアログ
* 幅: 0
* セルの間隔: 0
* セルのパディング: 5
+
image::images/insert-table.png[title="「挿入表」ダイアログ"]
-7. ソース・エディタ内を右クリックし、「フォーマット」を選択します。これでコードの体裁が整います。フォームは次のようになります。
-[source,xml]
+[start=7]
+. ソース・エディタ内を右クリックし、「フォーマット」を選択します。これでコードの体裁が整います。フォームは次のようになります。
+
+[source,html]
----
<form name="autofillform" action="autocomplete.php">
@@ -214,16 +235,20 @@ image::images/insert-table.png[title="「挿入表」ダイアログ"]
</form>
----
-8. 表の1行目の1列目に次のテキストを入力します(*太字*部分が変更箇所)。
-[source,xml]
+[start=8]
+. 表の1行目の1列目に次のテキストを入力します(*太字*部分が変更箇所)。
+
+[source,html]
----
<td>*<strong>Composer Name:</strong>*</td>
----
-9. 1行目の2列目では、パレットから「テキスト入力」フィールドをドラッグしないで、次のコードを手動で入力します。
-[source,java]
+[start=9]
+. 1行目の2列目では、パレットから「テキスト入力」フィールドをドラッグしないで、次のコードを手動で入力します。
+
+[source,html]
----
<input type="text"
@@ -233,14 +258,20 @@ image::images/insert-table.png[title="「挿入表」ダイアログ"]
----
入力するときは、IDEに組み込まれているコード補完サポートを使用してみてください。たとえば、「`<i`」と入力して[Ctrl]-[Space]を押します。カーソルの下に候補のリストが表示され、選択されている要素の説明が上のボックスに表示されます。ソース・エディタでコーディングしているときはいつでも[Ctrl]-[Space]を押して候補を表示できます。候補が1つのみの場合は、[Ctrl]-[Space]を押すと要素名が自動的に補完されます。
-image::images/code-completion.png[title="[Ctrl]-[Space]を押してソース・エディタでトリガーされたコード補完"]
+image:images/code-completion.png[title="[Ctrl]-[Space]を押してソース・エディタでトリガーされたコード補完"]
入力した`onkeyup`属性はJavaScript関数`doCompletion()`を指しています。この関数は、フォームのテキスト・フィールド内でキーが押されるたびにコールされ、Ajaxの<<flow-diagram,フロー図>>に示したJavaScriptコールに対応します。
-10. JavaScriptエディタでの作業に移る前に、アプリケーションのエントリ・ポイントとして`index.php`ファイルを新しい`index.html`ファイルに置き換えます。
-これを行うには、「プロジェクト」ウィンドウでプロジェクト・ノードを右クリックし、「プロパティ」を選択します。「*実行構成*」カテゴリを選択し、「開始ファイル」フィールドに「`index.html`」と入力します。image::images/php-entry-point.png[title="「プロジェクト・プロパティ」ウィンドウで、アプリケーションのエントリ・ポイントを指定します。"]
-11. 「OK」をクリックして変更を保存し、「プロジェクト・プロパティ」ウィンドウを終了します。
-12. プロジェクトを実行して、ブラウザでどのように表示されるかを確認します。「プロジェクトの実行」(image::images/run-project-btn.png[])ボタンをクリックします。`index.html`ファイルがデフォルトのブラウザに表示されます。
-image::images/index-page.png[title="プロジェクトを実行してブラウザに現在の状態を表示"]
+[start=10]
+. JavaScriptエディタでの作業に移る前に、アプリケーションのエントリ・ポイントとして`index.php`ファイルを新しい`index.html`ファイルに置き換えます。
+
+これを行うには、「プロジェクト」ウィンドウでプロジェクト・ノードを右クリックし、「プロパティ」を選択します。「*実行構成*」カテゴリを選択し、「開始ファイル」フィールドに「`index.html`」と入力します。image:images/php-entry-point.png[title="「プロジェクト・プロパティ」ウィンドウで、アプリケーションのエントリ・ポイントを指定します。"]
+
+[start=11]
+. 「OK」をクリックして変更を保存し、「プロジェクト・プロパティ」ウィンドウを終了します。
+
+[start=12]
+. プロジェクトを実行して、ブラウザでどのように表示されるかを確認します。「プロジェクトの実行」(image:images/run-project-btn.png[])ボタンをクリックします。`index.html`ファイルがデフォルトのブラウザに表示されます。
+image:images/index-page.png[title="プロジェクトを実行してブラウザに現在の状態を表示"]
[[javascript]]
@@ -260,7 +291,7 @@ IDEでは、Firefox、Internet Explorer、Safari、およびOperaをデフォル
2. ファイル名を`javascript`にし、「終了」をクリックします。新しいJavaScriptファイルが「プロジェクト」ウィンドウに表示され、エディタで開きます。
3. 次のコードを`javascript.js`に入力します。
-[source,java]
+[source,php]
----
var req;
@@ -294,9 +325,11 @@ function initRequest() {
上のコードは、Firefox 3およびInternet Explorerバージョン6と7の単純なブラウザ互換性チェックを行います。互換性の問題に対してさらに堅牢なコードを取り込むには、link:http://www.quirksmode.org[+http://www.quirksmode.org+]のlink:http://www.quirksmode.org/js/detect.html[+ブラウザ検出スクリプト+]を使用することを検討してください。
-4. `index.html`に戻り、JavaScriptファイルへの参照を`<head>`タグの間に追加します。
-[source,xml]
+[start=4]
+. `index.html`に戻り、JavaScriptファイルへの参照を`<head>`タグの間に追加します。
+
+[source,html]
----
<script type="text/javascript" src="javascript.js"></script>
@@ -305,9 +338,11 @@ function initRequest() {
[Ctrl]-[Tab]を押すと、エディタ内で開いているページを簡単に切り替えることができます。
-5. `init()`へのコールを開始`<body>`タグ内に挿入します。
-[source,java]
+[start=5]
+. `init()`へのコールを開始`<body>`タグ内に挿入します。
+
+[source,html]
----
<body *onload="init()"*>
@@ -329,7 +364,7 @@ function initRequest() {
* URL `autocomplete.php`、およびユーザーが`complete-field`に入力したテキスト
-[source,java]
+[source,php]
----
var url = "autocomplete.php?action=complete&id=" + escape(completeField.value);
@@ -337,7 +372,7 @@ var url = "autocomplete.php?action=complete&id=" + escape(completeField.valu
* `GET` (HTTPの相互作用で`GET`メソッドを使用することを示します)
* `true` (相互作用は非同期であることを示します)
-[source,java]
+[source,php]
----
req.open("GET", url, true);
@@ -346,7 +381,7 @@ req.open("GET", url, true);
相互作用を非同期に設定する場合は、コールバック関数を指定します。この相互作用のコールバック関数は次の文で設定します。
-[source,java]
+[source,php]
----
req.onreadystatechange = callback;
@@ -418,7 +453,9 @@ class ComposerData {
}
----
-4. エディタで、次のコードをクラス内に貼り付けます(変更箇所は*太字*で表示)。
+
+[start=4]
+. エディタで、次のコードをクラス内に貼り付けます(変更箇所は*太字*で表示)。
[source,php]
----
@@ -502,9 +539,12 @@ class ComposerData {
受信リクエストによって受け取る`autocomplete` URLを処理するロジックを実装します。前の項で説明したように、ファイル・ウィザードを使用して新しいPHPファイルを作成するかわりに、ここでは既存の`index.php`ファイルを変更します。
1. 「プロジェクト」ウィンドウで`index.php`ファイル・ノードをクリックします。ファイル名が編集可能になり、名前を変更できるようになります。
+
image::images/edit-file-name.png[title="ファイル・ノードをクリックして名前を編集"]
-2. ファイル名を`autocomplete`にし、[Enter]を押します。新しい`autocomplete.php`ファイルをダブルクリックし、エディタに表示します。
-3. このファイルの既存のコードを次のスクリプトに置き換えます。
+
+[start=2]
+. ファイル名を`autocomplete`にし、[Enter]を押します。新しい`autocomplete.php`ファイルをダブルクリックし、エディタに表示します。
+. このファイルの既存のコードを次のスクリプトに置き換えます。
[source,php]
----
@@ -676,7 +716,9 @@ function callback() {
</tr>
----
この新しい行は「`auto-row`」として識別でき、オートコンプリート・ボックスを形成する新しいHTML表を挿入するための、JavaScriptコード用のハンドルの役割を果たします。
-2. `javascript.js`をエディタで開き、次の3つの変数をファイルの先頭に追加します。
+
+[start=2]
+. `javascript.js`をエディタで開き、次の3つの変数をファイルの先頭に追加します。
[source,java]
----
@@ -685,7 +727,9 @@ var completeField;
var completeTable;
var autoRow;
----
-3. 次の*太字*の行を`init()`関数に追加します。
+
+[start=3]
+. 次の*太字*の行を`init()`関数に追加します。
[source,java]
----
@@ -711,7 +755,9 @@ function init() {
<td/>
</tr>
----
-4. `appendComposer()`を`javascript.js`に追加します。
+
+[start=4]
+. `appendComposer()`を`javascript.js`に追加します。
[source,java]
----
@@ -744,7 +790,9 @@ function appendComposer(firstName,lastName,composerId) {
}
----
この関数は、表の新しい行を作成し、3つのパラメータによって関数に渡されたデータを使用して作曲家へのリンクを挿入してから、行をindexページの`complete-table`要素に挿入します。
-5. `clearTable()`を`javascript.js`に追加します。
+
+[start=5]
+. `clearTable()`を`javascript.js`に追加します。
[source,java]
----
@@ -759,7 +807,9 @@ function clearTable() {
}
----
この関数は`complete-table`要素の表示を'none'に設定し(非表示にし)、作成された既存の作曲家の名前エントリを除去します。
-6. `getElementY()`を`javascript.js`に追加します。
+
+[start=6]
+. `getElementY()`を`javascript.js`に追加します。
[source,java]
----
@@ -783,7 +833,9 @@ function getElementY(element){
*注意: *link:http://www.quirksmode.org/[+http://www.quirksmode.org/+]にある`offset`に関するlink:http://www.quirksmode.org/js/findpos.html[+説明+]を参照してください。
-7. `callback()`関数を変更して、サーバーから新しいデータを受け取るたびに`clearTable()`をコールするようにします。オートコンプリート・ボックスに作曲家のエントリがある場合は、新しいエントリが入力される前に除去されます。
+
+[start=7]
+. `callback()`関数を変更して、サーバーから新しいデータを受け取るたびに`clearTable()`をコールするようにします。オートコンプリート・ボックスに作曲家のエントリがある場合は、新しいエントリが入力される前に除去されます。
[source,java]
----
@@ -799,7 +851,9 @@ function callback() {
}
}
----
-8. `parseMessages()`を`javascript.js`に追加します。
+
+[start=8]
+. `parseMessages()`を`javascript.js`に追加します。
[source,java]
----
@@ -853,14 +907,14 @@ function parseMessages(responseXML) {
これで、アプリケーションの機能に必要なコードが完成しました。作業の結果を確認するため、今すぐアプリケーションを実行してみてください。
-1. プロジェクトを実行して、ブラウザでどのように表示されるかを確認します。「プロジェクトの実行」(image::images/run-project-btn.png[])ボタンをクリックします。`index.html`ファイルがブラウザに表示されます。
-image::images/no-css.png[title="スタイル・シートなしでの正常なデプロイメント"]
+1. プロジェクトを実行して、ブラウザでどのように表示されるかを確認します。「プロジェクトの実行」(image:images/run-project-btn.png[])ボタンをクリックします。`index.html`ファイルがブラウザに表示されます。
+image:images/no-css.png[title="スタイル・シートなしでの正常なデプロイメント"]
アプリケーションにスタイル・シートを添付するには、CSS (Cascading Style Sheet)ファイルを作成し、プレゼンテーション・ページからそのファイルにリンクします。CSSファイルで作業する場合、IDEには、コード補完サポートや、スタイル・シート・ルールの作成に役立つ他のいくつかの機能が提供されています。これには次のものが含まれています。
* *CSSスタイル・ビルダー: *選択したコントロールやウィジェットを使用してルールを作成できるように設計されたインタフェースです(「ウィンドウ」>「その他」>「CSSスタイル・ビルダー」)。
* *CSSプレビュー:* ルール内にカーソルを置くと、そのルールの宣言ブロックに従ってサンプル・テキストがレンダリングされるプレビュー・ウィンドウです(「ウィンドウ」>「その他」>「CSSプレビュー」)。
-* *スタイル・ルール・エディタ: *クラス、ID、HTML要素に基づいてルールを作成し、ドキュメント階層における位置を設定できるダイアログです(CSSエディタのツールバーの左上側にある「ルールを作成」(image::images/style-rule-editor-btn.png[])ボタン)。
+* *スタイル・ルール・エディタ: *クラス、ID、HTML要素に基づいてルールを作成し、ドキュメント階層における位置を設定できるダイアログです(CSSエディタのツールバーの左上側にある「ルールを作成」(image:images/style-rule-editor-btn.png[])ボタン)。
NetBeans 6.9は、「名前の変更のリファクタリング」機能と「使用状況を検索」機能をサポートしています。これは、CSSファイルのみでなく、CSSコードが埋め込まれているすべてのファイルでサポートされます(HTML、PHPなど)。CSSのクラス、ID、およびタイプ要素を、すべてのプロジェクト・ファイルでリファクタリングできます。このリファクタリングのサポートを利用するには、任意のCSS要素上で[Ctrl]-[R]を押し、表示されたダイアログで名前変更アクションを実行します。また、名前変更アクションを実行する前に、変更をプレビューすることもできます。「使用状況を検索」機能のサポートを利用するには、CSS要素を右クリックし、「使用状況を検索」を選択します。詳細は、link:http://wiki.netbeans.org/wiki/index.php?title=NewAndNoteworthy69m1§ion=T-25#
Web_Languages[+NewAndNoteworthy69m1+]を参照してください。
@@ -940,7 +994,9 @@ a:hover {
CSSエディタ内を右クリックして「CSSの確認」を選択し、CSSコードの妥当性のチェックを実行します。エラーがあった場合は「出力」ウィンドウ(「ウィンドウ」>「出力」)に表示されます。
-5. エディタで`index.html`ページに切り替え([Ctrl]-[Tab]を押します)、`<head>`タグの間にスタイル・シートへの参照を追加します。
+
+[start=5]
+. エディタで`index.html`ページに切り替え([Ctrl]-[Tab]を押します)、`<head>`タグの間にスタイル・シートへの参照を追加します。
[source,java]
----
@@ -948,7 +1004,9 @@ CSSエディタ内を右クリックして「CSSの確認」を選択し、CSS
<link rel="stylesheet" type="text/css" href="stylesheet.css">
----
-6. アプリケーションをもう一度実行します。インデックス・ページが、作成したスタイル・シートを使用してブラウザに表示されます。文字を入力するたびに非同期のリクエストがサーバーに送信され、`autocomplete.php`によって作成されたXMLデータが返されます。さらに文字を入力すると、新しい一致リストを反映して作曲家の名前の数が減ります。
+
+[start=6]
+. アプリケーションをもう一度実行します。インデックス・ページが、作成したスタイル・シートを使用してブラウザに表示されます。文字を入力するたびに非同期のリクエストがサーバーに送信され、`autocomplete.php`によって作成されたXMLデータが返されます。さらに文字を入力すると、新しい一致リストを反映して作曲家の名前の数が減ります。
diff --git a/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart_pt_BR.asciidoc
index 995e06e..2195e73 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart_pt_BR.asciidoc
@@ -33,10 +33,6 @@ Este documento oferece uma introdução ao Ajax e demonstra algumas das funncion
Ajax significa Asynchronous JavaScript and XML. Na essência, o Ajax é uma forma eficiente de uma aplicação web tratar as interações do usuário com uma página web: uma forma que reduz a necessidade de fazer uma atualização da página ou uma recarga completa da página para cada interação do usuário. Isso permite um comportamento detalhado (semelhante ao de uma aplicação de área de trabalho ou aplicação web com base em plug-in) na utilização de um browser. As interações do Ajax são tratadas [...]
-
-image::images/netbeans-stamp-80-74-73.png[title="O conteúdo desta página se aplica ao NetBeans IDE 7.2, 7.3, 7.4 e 8.0"]
-
-
*Para concluir este tutorial, você precisa dos seguintes recursos e softwares.*
|===
@@ -89,21 +85,34 @@ Comece criando um novo projeto de aplicação PHP no IDE.
1. Escolha Arquivo > Novo Projeto. Em Categorias, selecione *PHP*. Em Projetos, selecione *Aplicação PHP* e, em seguida, clique em *Próximo*.
2. Na etapa 2: Nome e Localização, nomeie o projeto `MyAjaxApp`. O campo Pasta de Códigos-Fonte permite que você especifique o local do projeto no seu computador. Deixe as outras opções como default e clique em *Próximo*.
-image::images/php-name-location.png[title="Assistente Novo Projeto PHP: painel Nome e Localização"]
-3. Na etapa 3: Configuração de Execução, especifique como você deseja implantar a aplicação. Se tiver definido o ambiente de desenvolvimento do PHP configurando um pacote *AMP, deverá selecionar *Local Web Site* na lista drop-down e especificar o URL do projeto, como ele aparecerá em um browser.
-4. Selecione a opção Copiar arquivos da Pasta de Códigos-Fonte para outra localização. Em seguida, no campo Copiar para Pasta, digite o caminho para o local de implantação no servidor. (No Apache, é o diretório `htdocs` default.)
+
+image:images/php-name-location.png[title="Assistente Novo Projeto PHP: painel Nome e Localização"]
+
+
+[start=3]
+. Na etapa 3: Configuração de Execução, especifique como você deseja implantar a aplicação. Se tiver definido o ambiente de desenvolvimento do PHP configurando um pacote *AMP, deverá selecionar *Local Web Site* na lista drop-down e especificar o URL do projeto, como ele aparecerá em um browser.
+
+[start=4]
+. Selecione a opção Copiar arquivos da Pasta de Códigos-Fonte para outra localização. Em seguida, no campo Copiar para Pasta, digite o caminho para o local de implantação no servidor. (No Apache, é o diretório `htdocs` default.)
+
[.feature]
--
image::images/php-run-config.png[role="left", link="images/php-run-config.png"]
--
-5. Clique em *Finalizar*. O IDE criará a pasta do projeto em seu sistema de arquivos e o projeto será aberto no IDE.
+
+
+[start=5]
+. Clique em *Finalizar*. O IDE criará a pasta do projeto em seu sistema de arquivos e o projeto será aberto no IDE.
Você também pode utilizar o assistente Projeto para adicionar suporte ao framework para o projeto (fornecido na Etapa 4 do assistente).
Uma página de índice `index.php` default será gerada e aberta no editor do IDE. Além disso, seu projeto aparece na janela Projetos.
image::images/php-proj-win.png[title="A janela Projetos exibe o projeto MyAjaxApp"]
-6. Antes de começar a codificar, tente rapidamente executar a aplicação para garantir que a configuração entre o IDE, seu servidor e o browser esteja configurada corretamente.
+
+
+[start=6]
+. Antes de começar a codificar, tente rapidamente executar a aplicação para garantir que a configuração entre o IDE, seu servidor e o browser esteja configurada corretamente.
No editor do IDE, adicione uma instrução `echo` à página de índice:
@@ -116,9 +125,11 @@ No editor do IDE, adicione uma instrução `echo` à página de índice:
?>
----
-7. Na janela Projetos, clique com o botão direito do mouse no nó do projeto e selecione Executar. O IDE abrirá o browser default e exibirá a mensagem Olá Mundo que você acabou de criar em `index.php`.
-*Observação:* se tiver dificuldade em configurar o projeto ou estabelecer comunicação entre o IDE, o servidor e o browser, consulte link:project-setup.html[+Configurando um Projeto PHP+] para obter uma descrição mais aprofundada. A link:../../trails/php.html[+Trilha de Aprendizado do PHP+] pode oferecer mais informações sobre como configurar o ambiente.
+[start=7]
+. Na janela Projetos, clique com o botão direito do mouse no nó do projeto e selecione Executar. O IDE abrirá o browser default e exibirá a mensagem Olá Mundo que você acabou de criar em `index.php`.
+
+NOTE: se tiver dificuldade em configurar o projeto ou estabelecer comunicação entre o IDE, o servidor e o browser, consulte link:project-setup.html[+Configurando um Projeto PHP+] para obter uma descrição mais aprofundada. A link:../../trails/php.html[+Trilha de Aprendizado do PHP+] pode oferecer mais informações sobre como configurar o ambiente.
[[html]]
@@ -139,7 +150,7 @@ Você pode exibir ícones grandes (como exibido aqui) clicando com o botão dire
2. No assistente Arquivo HTML, nomeie o arquivo `index` e, em seguida, clique em *Finalizar*. O novo arquivo `index.html` será aberto no editor.
3. Substitua o conteúdo existente para os arquivos como se segue.
-[source,xml]
+[source,html]
----
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
@@ -156,7 +167,9 @@ Você pode exibir ícones grandes (como exibido aqui) clicando com o botão dire
</html>
----
-4. Adicione algum texto explicativo para descrever a finalidade do campo de texto. Você pode copiar e colar no texto a seguir, no ponto logo abaixo das tags `<h1>`:
+
+[start=4]
+. Adicione algum texto explicativo para descrever a finalidade do campo de texto. Você pode copiar e colar no texto a seguir, no ponto logo abaixo das tags `<h1>`:
[source,html]
----
@@ -169,16 +182,21 @@ Você pode exibir ícones grandes (como exibido aqui) clicando com o botão dire
then click on one of the selections to see composer details.</p>
----
-5. Adicione um form HTML à página. Faça isso utilizando os elementos listados na Paleta do IDE. Se a Paleta não estiver aberta, selecione Janela > Paleta no menu principal. Em seguida, em Forms HTML, clique e arraste um elemento Form para a página, um ponto abaixo das tags `<p>` que você acabou de adicionar. A caixa de diálogo Inserir Form será aberta. Especifique o seguinte:
+
+[start=5]
+. Adicione um form HTML à página. Faça isso utilizando os elementos listados na Paleta do IDE. Se a Paleta não estiver aberta, selecione Janela > Paleta no menu principal. Em seguida, em Forms HTML, clique e arraste um elemento Form para a página, um ponto abaixo das tags `<p>` que você acabou de adicionar. A caixa de diálogo Inserir Form será aberta. Especifique o seguinte:
* Ação: autocomplete.php
* Método: GET
* Nome: autofillform
+
image::images/php-insert-form.png[title="Caixa de diálogo Inserir form"]
Clique em OK. As tags HTML `<form>` serão inseridas na página que contém os atributos especificados. (GET é aplicado por default e, portanto, não é declarado explicitamente.)
-6. Adicione uma tabela HTML à página. Na categoria HTML na Paleta, clique em um elemento Tabela e arraste-o para um ponto entre as tags `<form>`. A caixa de diálogo Inserir Tabela será aberta. Especifique o seguinte:
+
+[start=6]
+. Adicione uma tabela HTML à página. Na categoria HTML na Paleta, clique em um elemento Tabela e arraste-o para um ponto entre as tags `<form>`. A caixa de diálogo Inserir Tabela será aberta. Especifique o seguinte:
* Linhas: 2
* Colunas: 2
@@ -186,10 +204,14 @@ Clique em OK. As tags HTML `<form>` serão inseridas na página que contém os a
* Largura: 0
* Espaçamento da Célula: 0
* Preenchimento de Células: 5
+
image::images/insert-table.png[title="Caixa de diálogo Inserir tabela"]
-7. Clique com o botão direito do mouse no Editor de Código-Fonte e selecione Formatar. Isso limpa o código. Seu form agora deve ser semelhante ao abaixo:
-[source,xml]
+
+[start=7]
+. Clique com o botão direito do mouse no Editor de Código-Fonte e selecione Formatar. Isso limpa o código. Seu form agora deve ser semelhante ao abaixo:
+
+[source,html]
----
<form name="autofillform" action="autocomplete.php">
@@ -214,16 +236,20 @@ image::images/insert-table.png[title="Caixa de diálogo Inserir tabela"]
</form>
----
-8. Na primeira linha da tabela, digite o seguinte texto na primeira coluna (alterações em *negrito*):
-[source,xml]
+[start=8]
+. Na primeira linha da tabela, digite o seguinte texto na primeira coluna (alterações em *negrito*):
+
+[source,html]
----
<td>*<strong>Composer Name:</strong>*</td>
----
-9. Na segunda coluna da primeira linha, em vez de arrastar um campo Entrada de Texto da Paleta, digite o código abaixo manualmente.
-[source,java]
+[start=9]
+. Na segunda coluna da primeira linha, em vez de arrastar um campo Entrada de Texto da Paleta, digite o código abaixo manualmente.
+
+[source,html]
----
<input type="text"
@@ -233,14 +259,21 @@ image::images/insert-table.png[title="Caixa de diálogo Inserir tabela"]
----
Enquanto digita, tente utilizar o suporte à funcionalidade autocompletar código incorporado do IDE. Por exemplo, digite `<i` e, em seguida, pressione Ctrl-Espaço. Uma lista de opções sugeridas será exibida abaixo do seu cursor e uma descrição do elemento selecionado aparecerá em uma caixa acima. De fato, você pode pressionar Ctrl-Espaço a qualquer momento em que estiver codificando no Editor de Código-Fonte para ter acesso às opções possíveis. Além disso, caso só haja uma opção possível, [...]
-image::images/code-completion.png[title="Ctrl-Espaço aciona a função autocompletar código no Editor de Código-Fonte"]
+image:images/code-completion.png[title="Ctrl-Espaço aciona a função autocompletar código no Editor de Código-Fonte"]
O atributo `onkeyup` que você digitou acima aponta para uma função JavaScript chamada `doCompletion()`. Essa função é chamada toda vez que uma tecla é pressionada no campo de texto do form, e mapeia para a chamada JavaScript representada no <<flow-diagram,fluxograma>> do Ajax acima.
-10. Antes de prosseguir para trabalhar no editor JavaScript, faça com que o novo arquivo `index.html` substitua o arquivo `index.php` como ponto de entrada da aplicação.
-Para fazê-lo, clique com o botão direito do mouse no nó do projeto na janela Projetos e selecione Propriedades. Selecione a categoria *Configuração de Execução* e, em seguida, digite `index.html` no campo Arquivo de Índice. image::images/php-entry-point.png[title="Especificar o ponto de entrada da aplicação na janela Propriedades do Projeto"]
-11. Clique em OK para salvar as alterações e sair da janela Propriedades do Projeto.
-12. Execute o projeto para ver como ele é em um browser. Clique no botão Executar Projeto (image::images/run-project-btn.png[]). O arquivo `index.html` será exibido no browser default.
-image::images/index-page.png[title="Executar projeto para exibir seu status atual no browser"]
+[start=10]
+. Antes de prosseguir para trabalhar no editor JavaScript, faça com que o novo arquivo `index.html` substitua o arquivo `index.php` como ponto de entrada da aplicação.
+
+Para fazê-lo, clique com o botão direito do mouse no nó do projeto na janela Projetos e selecione Propriedades. Selecione a categoria *Configuração de Execução* e, em seguida, digite `index.html` no campo Arquivo de Índice. image:images/php-entry-point.png[title="Especificar o ponto de entrada da aplicação na janela Propriedades do Projeto"]
+
+[start=11]
+. Clique em OK para salvar as alterações e sair da janela Propriedades do Projeto.
+
+[start=12]
+. Execute o projeto para ver como ele é em um browser. Clique no botão Executar Projeto (image:images/run-project-btn.png[]). O arquivo `index.html` será exibido no browser default.
+
+image:images/index-page.png[title="Executar projeto para exibir seu status atual no browser"]
[[javascript]]
@@ -260,7 +293,7 @@ Adicione um arquivo JavaScript à aplicação e comece a implementar `doCompleti
2. Nomeie o arquivo como `javascript` e clique em Finalizar. O novo arquivo JavaScript aparecerá na janela Projetos e será aberto no editor.
3. Digite o código abaixo em `javascript.js`.
-[source,java]
+[source,php]
----
var req;
@@ -294,9 +327,11 @@ function initRequest() {
O código acima executa um verificação simples de compatibilidade do browser para o Firefox 3 e para o Internet Explorer versões 6 e 7). Se desejar incorporar um código mais robusto para problemas de compatibilidade, considere usar este link:http://www.quirksmode.org/js/detect.html[+script de detecção de browser+] disponível em link:http://www.quirksmode.org[+http://www.quirksmode.org+].
-4. Volte para `index.html` e adicione uma referência ao arquivo JavaScript entre as tags `<head>`.
-[source,xml]
+[start=4]
+. Volte para `index.html` e adicione uma referência ao arquivo JavaScript entre as tags `<head>`.
+
+[source,html]
----
<script type="text/javascript" src="javascript.js"></script>
@@ -305,9 +340,11 @@ O código acima executa um verificação simples de compatibilidade do browser p
Você pode alternar rapidamente entre as páginas abertas no editor pressionando Ctrl-Tab.
-5. Insira uma chamada a `init()` na tag de abertura `<body>`.
-[source,java]
+[start=5]
+. Insira uma chamada a `init()` na tag de abertura `<body>`.
+
+[source,html]
----
<body *onload="init()"*>
@@ -329,7 +366,7 @@ Três parâmetros são especificados quando você cria um objeto `XMLHttpRequest
* O URL `autocomplete.php` e o texto digitado no `campo de conclusão` pelo usuário:
-[source,java]
+[source,php]
----
var url = "autocomplete.php?action=complete&id=" + escape(completeField.value);
@@ -337,7 +374,7 @@ var url = "autocomplete.php?action=complete&id=" + escape(completeField.valu
* `GET`, significando que as interações HTTP usam o método `GET`, e
* `true`, significando que a interação é assíncrona:
-[source,java]
+[source,php]
----
req.open("GET", url, true);
@@ -346,7 +383,7 @@ req.open("GET", url, true);
Se a interação for definida como assíncrona, uma função de chamada de retorno deve ser especificada. A função de chamada de retorno dessa interação é definida com a instrução:
-[source,java]
+[source,php]
----
req.onreadystatechange = callback;
@@ -418,7 +455,9 @@ class ComposerData {
}
----
-4. No editor, cole no código a seguir dentro da classe (alterações em *negrito*).
+
+[start=4]
+. No editor, cole no código a seguir dentro da classe (alterações em *negrito*).
[source,php]
----
@@ -502,7 +541,7 @@ class ComposerData {
Implemente a lógica para tratar o URL `autocomplete` que é recebido pela solicitação de entrada. Em vez de criar um novo arquivo PHP utilizando o assistente Arquivo como demonstrado na seção anterior, modifique o arquivo `index.php` existente para esse propósito.
1. Na janela Projetos, clique no nó de arquivo `index.php`. O nome do arquivo se tornará editável, permitindo modificar o nome.
-image::images/edit-file-name.png[title="Clique nos nós dos arquivos para editar os nomes"]
+image:images/edit-file-name.png[title="Clique nos nós dos arquivos para editar os nomes"]
2. Nomeie o arquivo `autocomplete` e, em seguida, clique em Entrar. Clique duas vezes no novo arquivo `autocomplete.php` para que ele seja exibido no editor.
3. Substitua o código existente do arquivo pelo script a seguir.
@@ -571,7 +610,7 @@ if(isset($_GET['action']) && isset($_GET['id']) && $_GET['action
?>
----
-*Observação: * o arquivo composerView.php não é descrito neste tutorial. Você pode criar um arquivo para ver o resultado final da pesquisa. Uma amostra do arquivo é incluída na link:https://netbeans.org/projects/samples/downloads/download/Samples%252FPHP%252FMyAjaxApp.zip[+aplicação de amostra+].
+NOTE: o arquivo composerView.php não é descrito neste tutorial. Você pode criar um arquivo para ver o resultado final da pesquisa. Uma amostra do arquivo é incluída na link:https://netbeans.org/projects/samples/downloads/download/Samples%252FPHP%252FMyAjaxApp.zip[+aplicação de amostra+].
Como você pode ver, não há nada realmente novo que precise ser aprendido para escrever código no servidor para processamento em Ajax. O tipo de conteúdo da resposta precisa ser definido como `text/xml` para casos em que você deseje trocar documentos XML. Com o Ajax você também pode trocar texto simples ou até mesmo snippets de JavaScript, que podem ser avaliados ou executados pela função chamada de retorno no cliente. Observe também que alguns browsers podem armazenar no cache os resulta [...]
@@ -662,7 +701,7 @@ Observe que a função `parseMessages()` somente é chamada quando o `XMLHttpReq
A função `parseMessages()` trata os dados XML de entrada. Fazendo isso, ela conta com várias funções auxiliares, como `appendComposer()`, `getElementY()` e `clearTable()`. Você também deve introduzir novos elementos na página de índice, como uma segunda tabela HTML que serve como a caixa autocompletar, e os IDs dos elementos, para que eles possam ser referenciados em `javascript.js`. Finalmente, crie novas variáveis que correspondam a IDs para os elementos em `index.php`, inicialize-as n [...]
-*Observação: *As funções e elementos que você cria nas etapas seguintes funcionam de forma interdependente. Recomendamos que você percorra esta seção e, em seguida, examine o código quando tudo estiver no lugar.
+NOTE: As funções e elementos que você cria nas etapas seguintes funcionam de forma interdependente. Recomendamos que você percorra esta seção e, em seguida, examine o código quando tudo estiver no lugar.
1. Abra `index.html` no editor e digite o código abaixo para a segunda linha da tabela HTML criada anteriormente.
@@ -676,7 +715,9 @@ A função `parseMessages()` trata os dados XML de entrada. Fazendo isso, ela co
</tr>
----
Essa nova linha, que pode ser identificada como "`auto-row`", funciona como um handler para o código JavaScript cujo objetivo é inserir uma nova tabela HTML que formará a caixa da funcionalidade autocompletar.
-2. Abra `javascript.js` no editor e as três variáveis a seguir na parte superior do arquivo.
+
+[start=2]
+. Abra `javascript.js` no editor e as três variáveis a seguir na parte superior do arquivo.
[source,java]
----
@@ -685,7 +726,9 @@ var completeField;
var completeTable;
var autoRow;
----
-3. Adicione as seguintes linhas (em *negrito*) na função `init()`.
+
+[start=3]
+. Adicione as seguintes linhas (em *negrito*) na função `init()`.
[source,java]
----
@@ -711,7 +754,9 @@ Uma finalidade de `init()` é tornar os elementos que estão dentro de `index.ht
<td/>
</tr>
----
-4. Adicione `appendComposer()` a `javascript.js`.
+
+[start=4]
+. Adicione `appendComposer()` a `javascript.js`.
[source,java]
----
@@ -744,7 +789,9 @@ function appendComposer(firstName,lastName,composerId) {
}
----
Essa função cria uma nova linha da tabela, insere um link em um criador utilizando os dados passados para a função por meio de seus três parâmetros e insere a linha no elemento `complete-table` da página de índice.
-5. Adicione `clearTable()` a `javascript.js`.
+
+[start=5]
+. Adicione `clearTable()` a `javascript.js`.
[source,java]
----
@@ -759,7 +806,9 @@ function clearTable() {
}
----
Essa função define a exibição do elemento `complete-table` como "none" (ou seja, o torna invisível) e remove quaisquer entradas de nome de criador existentes que tenham sido criadas.
-6. Adicione `getElementY()` a `javascript.js`.
+
+[start=6]
+. Adicione `getElementY()` a `javascript.js`.
[source,java]
----
@@ -781,9 +830,11 @@ function getElementY(element){
----
Essa função é aplicada para localizar a posição vertical do elemento pai. Isso é necessário porque a posição real do elemento, quando ele é exibido, frequentemente depende do tipo e da versão do browser. Note que o elemento `complete-table`, quando é exibido contendo nomes de criador, é deslocado para o lado direito inferior da tabela em que ele está. O posicionamento correto da altura é determinado por `getElementY()`.
-*Observação: *Consulte link:http://www.quirksmode.org/js/findpos.html[+esta explicação+] de `offset` em link:http://www.quirksmode.org/[+http://www.quirksmode.org/+].
+NOTE: Consulte link:http://www.quirksmode.org/js/findpos.html[+esta explicação+] de `offset` em link:http://www.quirksmode.org/[+http://www.quirksmode.org/+].
+
-7. Modifique a função `callback()` para que chame `clearTable()` cada vez que novos dados forem recebidos do servidor. Quaisquer entradas do criador que já existam na caixa autocompletar serão, portanto, removidas, antes que esta seja preenchida com novas entradas.
+[start=7]
+. Modifique a função `callback()` para que chame `clearTable()` cada vez que novos dados forem recebidos do servidor. Quaisquer entradas do criador que já existam na caixa autocompletar serão, portanto, removidas, antes que esta seja preenchida com novas entradas.
[source,java]
----
@@ -799,7 +850,9 @@ function callback() {
}
}
----
-8. Adicione `parseMessages()` a `javascript.js`.
+
+[start=8]
+. Adicione `parseMessages()` a `javascript.js`.
[source,java]
----
@@ -853,14 +906,14 @@ A atualização dinâmica do elemento `complete-table` representa a etapa final
Nesse estágio, você concluiu todo o código necessário para a funcionalidade da aplicação. Para ver os resultados dos seus esforços, tente executar a aplicação agora.
-1. Execute o projeto para ver como ele é em um browser. Clique no botão Executar Projeto (image::images/run-project-btn.png[]). O arquivo `index.html` será exibido no seu browser.
-image::images/no-css.png[title="Implantação com sucesso sem folha de estilo"]
+1. Execute o projeto para ver como ele é em um browser. Clique no botão Executar Projeto (image:images/run-project-btn.png[]). O arquivo `index.html` será exibido no seu browser.
+image:images/no-css.png[title="Implantação com sucesso sem folha de estilo"]
Para anexar uma folha de estilo à sua aplicação, basta criar um arquivo CSS (Cascading Style Sheet) e vincule-o a partir das suas páginas de apresentação. Quando você trabalha em arquivos CSS, o IDE fornece o suporte à funcionalidade autocompletar código, assim como várias outras funcionalidades que podem ajudar na produção de regras de folha de estilo. Entre eles se incluem:
* *Construtor de Estilo CSS:* uma interface criada para permitir que você crie regras utilizando uma seleção de controles e widgets. (Janela > Outro > Construtor de Estilo CSS)
* *Visualização de CSS:* uma janela de visualização que, quando você coloca o cursor em uma regra, exibe o texto de amostra renderizado de acordo com o bloco de declaração dessa regra. (Janela > Outro > Visualização CSS)
-* *Editor de Regras de Estilo:* uma caixa de diálogo que permite que você crie regras com base em classes, IDs e elementos HTML e que defina sua posição na hierarquia do documento. (Botão Criar Regra ( image::images/style-rule-editor-btn.png[] ), localizado na região esquerda superior da barra de editores do CSS)
+* *Editor de Regras de Estilo:* uma caixa de diálogo que permite que você crie regras com base em classes, IDs e elementos HTML e que defina sua posição na hierarquia do documento. (Botão Criar Regra ( image:images/style-rule-editor-btn.png[] ), localizado na região esquerda superior da barra de editores do CSS)
O NetBeans 6.9 fornece o suporte Encontrar Utilidades e Refatoração Renomear. Esse suporte está disponível não somente em arquivos css, mas em todos os arquivos contendo código CSS incorporados (exemplo, HTML, PHP). Classes CSS, ids e elementos de tipo podem ser refatorados em todos os arquivos do projeto. Para fazer uso desse suporte a refatoração, pressione Ctrl-R em um dado elemento CSS e utilize a caixa de diálogo fornecida para efetuar a ação de renomear. Você também pode visualizar [...]
@@ -940,7 +993,9 @@ a:hover {
Execute uma verificação da validade do seu código CSS, clicando com o botão direito do mouse no Editor CSS e selecionando Verificar CSS. Quaisquer erros encontrados são exibidos na janela de Saída (Janelas > Saída).
-5. Alterne para a página `index.html` no editor (pressione Ctrl-Tab) e adicione uma referência à folha de estilo entre as tags `<head>`.
+
+[start=5]
+. Alterne para a página `index.html` no editor (pressione Ctrl-Tab) e adicione uma referência à folha de estilo entre as tags `<head>`.
[source,java]
----
@@ -948,7 +1003,9 @@ Execute uma verificação da validade do seu código CSS, clicando com o botão
<link rel="stylesheet" type="text/css" href="stylesheet.css">
----
-6. Execute a aplicação novamente. A página de índice é exibida no browser utilizando a folha de estilo recém-criada. Toda vez que você digita um caractere, uma solicitação assíncrona é enviada para o servidor e retornada com dados XML que foram preparados por `autocomplete.php`. Conforme você digita mais caracteres, o número de nomes de criador diminui para refletir a nova lista de correspondências.
+
+[start=6]
+. Execute a aplicação novamente. A página de índice é exibida no browser utilizando a folha de estilo recém-criada. Toda vez que você digita um caractere, uma solicitação assíncrona é enviada para o servidor e retornada com dados XML que foram preparados por `autocomplete.php`. Conforme você digita mais caracteres, o número de nomes de criador diminui para refletir a nova lista de correspondências.
diff --git a/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart_ru.asciidoc
index 0c53d10..41bc13f 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart_ru.asciidoc
@@ -89,21 +89,30 @@ image::images/ajax-process-flow.png[title="Диаграма потоков пр
1. Выберите команду "Файл" > "Новый проект". В области "Категории" выберите *PHP*. В области "Проекты" выберите *Приложение PHP* и нажмите кнопку *Далее*.
2. На втором экране "Имя и местоположение" назовите проект `MyAjaxApp`. Поле "Папка источников" позволяет определять местоположение проекта в системе. *Для всех остальных параметров примите значения по умолчанию и нажмите кнопку "Далее".*
+
image::images/php-name-location.png[title="Мастер создания проектов PHP - панель 'Имя и местоположение'"]
-3. На третьем экране "Настройки выполнения" укажите способ развертывания приложения. Если среда разработки PHP формировалась путем настройки пакета *AMP, необходимо выбрать в раскрывающемся списке пункт *Локальный веб-сайт* и указать URL-адрес проекта, который должен использоваться в браузере.
-4. Выберите параметр "Скопировать файлы из папки источников в другое расположение". Затем в поле "Скопировать в папку" введите путь к местоположению для развертывания на сервере. На сервере Apache по умолчанию используется каталог `htdocs`.
+
+[start=3]
+. На третьем экране "Настройки выполнения" укажите способ развертывания приложения. Если среда разработки PHP формировалась путем настройки пакета *AMP, необходимо выбрать в раскрывающемся списке пункт *Локальный веб-сайт* и указать URL-адрес проекта, который должен использоваться в браузере.
+
+[start=4]
+. Выберите параметр "Скопировать файлы из папки источников в другое расположение". Затем в поле "Скопировать в папку" введите путь к местоположению для развертывания на сервере. На сервере Apache по умолчанию используется каталог `htdocs`.
[.feature]
--
image::images/php-run-config.png[role="left", link="images/php-run-config.png"]
--
-5. Нажмите кнопку *Готово*. Среда IDE создает папку проекта в файловой системе, после чего этот проект открывается в среде IDE.
+
+[start=5]
+. Нажмите кнопку *Готово*. Среда IDE создает папку проекта в файловой системе, после чего этот проект открывается в среде IDE.
Также можно использовать мастер проектов для добавления в проект платформенной поддержки (предоставляется в действии 4 мастера проектов)
В редакторе среды IDE создается и открывается значение страницы `index.php` по умолчанию. Кроме того, проект появляется в окне "Проекты".
image::images/php-proj-win.png[title="В окне 'Проекты' отображается проект MyAjaxApp"]
-6. Перед написанием программы попробуйте запустить приложение в целях проверки правильности настройки взаимосвязи между средой IDE, сервером и браузером.
+
+[start=6]
+. Перед написанием программы попробуйте запустить приложение в целях проверки правильности настройки взаимосвязи между средой IDE, сервером и браузером.
В редакторе среды IDE добавьте оператор `echo` к начальной странице:
@@ -116,9 +125,11 @@ image::images/php-proj-win.png[title="В окне 'Проекты' отобра
?>
----
-7. В окне "Проекты" щелкните правой кнопкой мыши узел проекта и выберите команду "Выполнить". В среде IDE открывается браузер по умолчанию, и на экране появляется сообщение "Hello World", только что созданное в `index.php`.
-*Примечание.* При возникновении ошибок при настройке проекта или создании соединения между IDE, сервером и браузером более детальное описание см. в разделе link:project-setup.html[+Настройка проекта PHP+]. Дополнительные сведения относительно настройки среды содержатся в link:../../trails/php.html[+учебной карте PHP+].
+[start=7]
+. В окне "Проекты" щелкните правой кнопкой мыши узел проекта и выберите команду "Выполнить". В среде IDE открывается браузер по умолчанию, и на экране появляется сообщение "Hello World", только что созданное в `index.php`.
+
+NOTE: При возникновении ошибок при настройке проекта или создании соединения между IDE, сервером и браузером более детальное описание см. в разделе link:project-setup.html[+Настройка проекта PHP+]. Дополнительные сведения относительно настройки среды содержатся в link:../../trails/php.html[+учебной карте PHP+].
[[html]]
@@ -139,7 +150,7 @@ image::images/palette.png[title="На палитре отображаются э
2. В мастере создания файла HTML введите имя файла `index`, затем нажмите кнопку *Готово*. В редакторе открывается созданный файл `index.html`.
3. Замените содержимое файла на следующее:
-[source,xml]
+[source,html]
----
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
@@ -156,7 +167,9 @@ image::images/palette.png[title="На палитре отображаются э
</html>
----
-4. Для описания назначения текстового поля следует добавить соответствующий пояснительный текст. Непосредственно под тегами `<h1>` можно скопировать и вставить следующий текст:
+
+[start=4]
+. Для описания назначения текстового поля следует добавить соответствующий пояснительный текст. Непосредственно под тегами `<h1>` можно скопировать и вставить следующий текст:
[source,html]
----
@@ -169,16 +182,21 @@ image::images/palette.png[title="На палитре отображаются э
then click on one of the selections to see composer details.</p>
----
-5. Добавьте к странице форму HTML. Для этого можно использовать элементы, содержащиеся в палитре среды IDE. Если палитра не открыта, выберите в главном меню "Окно" > "Палитра". Затем перейдите к узлу "Формы HTML", выберите элемент "Форма" и перетащите его на страницу под только что добавленные теги `<p>`. Появится диалоговое окно "Вставить форму". Введите следующее:
+
+[start=5]
+. Добавьте к странице форму HTML. Для этого можно использовать элементы, содержащиеся в палитре среды IDE. Если палитра не открыта, выберите в главном меню "Окно" > "Палитра". Затем перейдите к узлу "Формы HTML", выберите элемент "Форма" и перетащите его на страницу под только что добавленные теги `<p>`. Появится диалоговое окно "Вставить форму". Введите следующее:
* Action: response.jsp;
* Method: GET;
* Имя: autofillform
+
image::images/php-insert-form.png[title="Диалоговое окно 'Вставить форму'"]
Нажмите кнопку "ОК". Теги HTML `<form>` вставляются в страницу, содержащую указанные атрибуты. (Метод GET применяется по умолчанию, и, следовательно, не объявляется явно).
-6. Добавьте к странице таблицу HTML. В категории палитры "HTML" выберите элемент "Таблица" и перетащите его непосредственно под теги `<form>`. Откроется диалоговое окно "Вставить таблицу". Введите следующее:
+
+[start=6]
+. Добавьте к странице таблицу HTML. В категории палитры "HTML" выберите элемент "Таблица" и перетащите его непосредственно под теги `<form>`. Откроется диалоговое окно "Вставить таблицу". Введите следующее:
* Рядов : 2
* Столбцов : 2
@@ -186,10 +204,14 @@ image::images/php-insert-form.png[title="Диалоговое окно 'Вста
* Ширина: 0
* Интервал между ячейками: 0
* Заполнение ячеек: 5
+
image::images/insert-table.png[title="Диалоговое окно 'Вставить таблицу'"]
-7. Щелкните правой кнопкой мыши редактор исходного кода и выберите команду "Форматировать". Последует выравнивание кода. Теперь форма должна выглядеть следующим образом:
-[source,xml]
+
+[start=7]
+. Щелкните правой кнопкой мыши редактор исходного кода и выберите команду "Форматировать". Последует выравнивание кода. Теперь форма должна выглядеть следующим образом:
+
+[source,html]
----
<form name="autofillform" action="autocomplete.php">
@@ -214,16 +236,20 @@ image::images/insert-table.png[title="Диалоговое окно 'Встав
</form>
----
-8. В первый столбец первой строки таблицы введите следующий текст (изменения выделены *полужирным шрифтом*):
-[source,xml]
+[start=8]
+. В первый столбец первой строки таблицы введите следующий текст (изменения выделены *полужирным шрифтом*):
+
+[source,html]
----
<td>*<strong>Composer Name:</strong>*</td>
----
-9. Во второй столбец первой строки вручную введите указанный ниже код (вместо перетаскивания поля "Ввод текста" из окна "Палитра").
-[source,java]
+[start=9]
+. Во второй столбец первой строки вручную введите указанный ниже код (вместо перетаскивания поля "Ввод текста" из окна "Палитра").
+
+[source,html]
----
<input type="text"
@@ -233,13 +259,20 @@ image::images/insert-table.png[title="Диалоговое окно 'Встав
----
При вводе кода можно использовать встроенную в среду IDE функцию автозавершения кода. Например, введите `<i`, а затем нажмите CTRL+ПРОБЕЛ. Список предлагаемых вариантов выбора отображается под курсором, а в расположенном выше поле появляется описание выбранного элемента. Для получения возможных вариантов выбора при написании кода достаточно в любой момент нажать в редакторе исходного кода сочетание клавиш CTRL+ПРОБЕЛ. Кроме того, при наличии единственного возможного варианта выбора нажат [...]
-image::images/code-completion.png[title="Нажатие Ctrl-Space инициирует автозавершение кода в редакторе исходного кода"]
+image:images/code-completion.png[title="Нажатие Ctrl-Space инициирует автозавершение кода в редакторе исходного кода"]
Атрибут `onkeyup`, введенный выше, указывает на функцию JavaScript с именем `doCompletion()`. Эта функция вызывается при каждом нажатии клавиши в текстовом поле формы и соответствует вызову JavaScript на приведенной выше <<flow-diagram,блок-схеме>> Ajax.
-10. Перед переходом к работе с редактором JavaScript, замените файлом `index.html` файл `index.php` в качестве точки входа приложения.
-Щелкните правой кнопкой мыши узел проекта в окне "Проекты" и выберите команду "Свойства". Выберите категорию *Конфигурация выполнения*, затем введите `index.html` в поле 'Файл индекса'. image::images/php-entry-point.png[title="Укажите точку входа приложения в окне 'Свойства проекта'"]
-11. Нажмите кнопку "ОК" для подтверждения изменений и закройте окно "Свойства проекта".
-12. Выполните проект и посмотрите, как он выглядит в браузере. Нажмите кнопку 'Запустить проект' ( image::images/run-project-btn.png[] ). Файл `index.html` открывается в браузере по умолчанию.
+[start=10]
+. Перед переходом к работе с редактором JavaScript, замените файлом `index.html` файл `index.php` в качестве точки входа приложения.
+
+Щелкните правой кнопкой мыши узел проекта в окне "Проекты" и выберите команду "Свойства". Выберите категорию *Конфигурация выполнения*, затем введите `index.html` в поле 'Файл индекса'. image:images/php-entry-point.png[title="Укажите точку входа приложения в окне 'Свойства проекта'"]
+
+[start=11]
+. Нажмите кнопку "ОК" для подтверждения изменений и закройте окно "Свойства проекта".
+
+[start=12]
+. Выполните проект и посмотрите, как он выглядит в браузере. Нажмите кнопку 'Запустить проект' ( image:images/run-project-btn.png[] ). Файл `index.html` открывается в браузере по умолчанию.
+
image::images/index-page.png[title="Выполните проект для просмотра его текущего состояния в браузере"]
@@ -260,7 +293,7 @@ image::images/php-javascript-options.png[title="Панель 'Параметры
2. Назовите файл `javascript` и нажмите кнопку "Готово". Новый файл JavaScript появится в окне "Проекты" и может быть открыт в редакторе.
3. Введите приведенный ниже код в файл `javascript.js`.
-[source,java]
+[source,php]
----
var req;
@@ -294,9 +327,11 @@ function initRequest() {
С помощью этого кода выполняется простая проверка совместимости веб-браузеров Firefox 3 и Internet Explorer версий 6 и 7). Если требуется добавить более надежный код, устраняющий ошибки совместимости, используйте link:http://www.quirksmode.org/js/detect.html[+сценарий для определения браузера+] с веб-сайта link:http://www.quirksmode.org[+http://www.quirksmode.org+].
-4. Вернитесь к `index.php` и добавьте справочную информацию в файл JavaScript между тегами `<head>`.
-[source,xml]
+[start=4]
+. Вернитесь к `index.php` и добавьте справочную информацию в файл JavaScript между тегами `<head>`.
+
+[source,html]
----
<script type="text/javascript" src="javascript.js"></script>
@@ -305,9 +340,11 @@ function initRequest() {
Для быстрого перехода между страницами, открытыми в редакторе, можно воспользоваться сочетанием клавиш CTRL+TAB.
-5. Вставьте вызов `init()` после открывающего тега `<body>`.
-[source,java]
+[start=5]
+. Вставьте вызов `init()` после открывающего тега `<body>`.
+
+[source,html]
----
<body *onload="init()"*>
@@ -329,7 +366,7 @@ function initRequest() {
* URL-адрес `autocomplete.php` и текст, введенный пользователем в поле `complete-field`:
-[source,java]
+[source,php]
----
var url = "autocomplete.php?action=complete&id=" + escape(completeField.value);
@@ -337,7 +374,7 @@ var url = "autocomplete.php?action=complete&id=" + escape(completeField.valu
* `GET` означает, что взаимодействия HTTP используют метод `GET`;
* `true` означает, что взаимодействие является асинхронным:
-[source,java]
+[source,php]
----
req.open("GET", url, true);
@@ -346,7 +383,7 @@ req.open("GET", url, true);
Если взаимодействие определено как асинхронное, необходимо указать функцию обратного вызова. Функция обратного вызова для этого взаимодействия определяется при помощи следующего оператора:
-[source,java]
+[source,php]
----
req.onreadystatechange = callback;
@@ -418,7 +455,9 @@ class ComposerData {
}
----
-4. Вставьте в класс в редакторе следующий код (изменения выделены *полужирным шрифтом*).
+
+[start=4]
+. Вставьте в класс в редакторе следующий код (изменения выделены *полужирным шрифтом*).
[source,php]
----
@@ -502,9 +541,15 @@ class ComposerData {
Создайте сервлет для обработки URL-адреса `autocomplete`, получаемого при входящем запросе. Вместо создания нового файла PHP с помощью мастера создания файлов, как показано в прошлом разделе, измените для этой цели существующий файл `index.php`.
1. В окне "Проекты" щелкните узел файла `index.php`. Появляется поле редактирования имени файла.
+
image::images/edit-file-name.png[title="Щелкните узлы файлов для редактирования имен"]
-2. Назовите файл `autocomplete` и нажмите ENTER. Дважды щелкните файл `autocomplete.php`, чтобы открыть его в редакторе.
-3. Замените код файла на следующий.
+
+
+[start=2]
+. Назовите файл `autocomplete` и нажмите ENTER. Дважды щелкните файл `autocomplete.php`, чтобы открыть его в редакторе.
+
+[start=3]
+. Замените код файла на следующий.
[source,php]
----
@@ -571,7 +616,7 @@ if(isset($_GET['action']) && isset($_GET['id']) && $_GET['action
?>
----
-*Примечание. * Файл composerView.php в данном учебном курсе не описывается. Этот файл можно создать для просмотра итоговых результатов поиска. Образец файла включен в link:https://netbeans.org/projects/samples/downloads/download/Samples%252FPHP%252FMyAjaxApp.zip[+образец приложения+].
+NOTE: Файл composerView.php в данном учебном курсе не описывается. Этот файл можно создать для просмотра итоговых результатов поиска. Образец файла включен в link:https://netbeans.org/projects/samples/downloads/download/Samples%252FPHP%252FMyAjaxApp.zip[+образец приложения+].
Итак, создание кода на стороне сервера для обработки с использованием Ajax не требует каких-либо новых знаний. Для случаев, когда требуется обмен документами XML, тип содержимого ответа должен иметь значение `text/xml`. Кроме того, Ajax позволяет осуществлять обмен простыми текстами или даже фрагментами JavaScript, которые могут анализироваться или выполняться с использованием функции обратного вызова на стороне клиента. Обратите внимание на то, что некоторые браузеры могут кэшировать ре [...]
@@ -662,7 +707,7 @@ function callback() {
Функция `parseMessages()` позволяет выполнять обработку входящих данных XML. При этом, в указанной функции используются несколько вспомогательных функций, например `appendComposer()`, `getElementY()` и `clearTable()`. Кроме того, необходимо ввести новые элементы для страницы-указателя, например, вторую таблицу HTML, которая служит в качестве поля автозавершения, и идентификаторы для элементов, обеспечивающие возможность вызова в `javascript.js`. Наконец, следует создать новые переменные, [...]
-*Примечание.* Функции и элементы, которые создаются в следующих действиях, являются взаимозависимыми. После выполнения рекомендаций, приведенных в этом разделе, необходимо выполнить тщательную проверку реализованного кода.
+NOTE: Функции и элементы, которые создаются в следующих действиях, являются взаимозависимыми. После выполнения рекомендаций, приведенных в этом разделе, необходимо выполнить тщательную проверку реализованного кода.
1. Откройте `index.php` в редакторе и введите указанный ниже код во вторую строку предварительно созданной таблицы HTML.
@@ -676,7 +721,9 @@ function callback() {
</tr>
----
Эта строка с идентификатором "`auto-row`" служит меткой для кода JavaScript, который вставляет новую таблицу HTML для формирования окна автозавершения.
-2. Откройте файл `javascript.js` в редакторе и добавьте к верхнему фрагменту файла следующие переменные.
+
+[start=2]
+. Откройте файл `javascript.js` в редакторе и добавьте к верхнему фрагменту файла следующие переменные.
[source,java]
----
@@ -685,7 +732,9 @@ var completeField;
var completeTable;
var autoRow;
----
-3. Добавьте следующие строки (выделенные *полужирным шрифтом*) к функции `init()`.
+
+[start=3]
+. Добавьте следующие строки (выделенные *полужирным шрифтом*) к функции `init()`.
[source,java]
----
@@ -711,7 +760,9 @@ function init() {
<td/>
</tr>
----
-4. Добавьте `appendComposer()` в `javascript.js`.
+
+[start=4]
+. Добавьте `appendComposer()` в `javascript.js`.
[source,java]
----
@@ -744,7 +795,9 @@ function appendComposer(firstName,lastName,composerId) {
}
----
Эта функция позволяет создавать новую строку таблицы и вставлять в нее ссылку на композитора с использованием данных, передаваемых в функцию посредством соответствующих трех параметров, а затем вставлять эту строку в элемент `complete-table` страницы-указателя.
-5. Добавьте `clearTable()` в `javascript.js`.
+
+[start=5]
+. Добавьте `clearTable()` в `javascript.js`.
[source,java]
----
@@ -759,7 +812,9 @@ function clearTable() {
}
----
Эта функция позволяет скрывать элемент `complete-table` (т.е. делать его невидимым), но не удаляет какие-либо существующие записи имен композиторов, созданные ранее.
-6. Добавьте `getElementY()` в `javascript.js`.
+
+[start=6]
+. Добавьте `getElementY()` в `javascript.js`.
[source,java]
----
@@ -781,9 +836,11 @@ function getElementY(element){
----
Указанная функция применяется для определения вертикальной позиции исходного элемента. Это является необходимым, поскольку фактическое расположение элемента при его отображении часто зависит от типа и версии браузера. Следует отметить, что при отображении на экране элемент `complete-table`, содержащий имена композиторов, перемещается в нижнюю правую часть таблицы, в которой он расположен. Правильное расположение по высоте определяется `getElementY()`.
-*Примечание.* См. link:http://www.quirksmode.org/js/findpos.html[+это описание+] `смещения` в link:http://www.quirksmode.org/[+http://www.quirksmode.org/+].
+NOTE: См. link:http://www.quirksmode.org/js/findpos.html[+это описание+] `смещения` в link:http://www.quirksmode.org/[+http://www.quirksmode.org/+].
+
-7. Для вызова `clearTable()` при каждом получении данных с сервера можно соответствующим образом изменить функцию `callback()`. Поэтому любые скомбинированные записи, существующие в окне автозавершения, удаляются до того, как выполняется заполнение новыми записями.
+[start=7]
+. Для вызова `clearTable()` при каждом получении данных с сервера можно соответствующим образом изменить функцию `callback()`. Поэтому любые скомбинированные записи, существующие в окне автозавершения, удаляются до того, как выполняется заполнение новыми записями.
[source,java]
----
@@ -799,7 +856,9 @@ function callback() {
}
}
----
-8. Добавьте `parseMessages()` в `javascript.js`.
+
+[start=8]
+. Добавьте `parseMessages()` в `javascript.js`.
[source,java]
----
@@ -853,14 +912,14 @@ function parseMessages(responseXML) {
На данном этапе создан весь код, необходимый для реализации функциональных возможностей приложения. Теперь для проверки результатов следует попытаться запустить приложение.
-1. Выполните проект и посмотрите, как он выглядит в браузере. Нажмите кнопку 'Запустить проект' ( image::images/run-project-btn.png[] ). В браузере отображается файл `index.html`.
-image::images/no-css.png[title="Успешное развертывание без таблицы стилей"]
+1. Выполните проект и посмотрите, как он выглядит в браузере. Нажмите кнопку 'Запустить проект' ( image:images/run-project-btn.png[] ). В браузере отображается файл `index.html`.
+image:images/no-css.png[title="Успешное развертывание без таблицы стилей"]
Для присоединения к приложению таблицы стилей достаточно просто создать файл .css и ссылку на этот файл со страниц представления. При работе с файлами CSS среда IDE предоставляет поддержку автозавершения кода, а также некоторые другие возможности для упрощения процесса создания правил таблицы стилей. В частности, это следующие возможности:
* *Конструктор стилей CSS:* интерфейс, разработанный для создания правил с использованием определенного набора элементов управления и оформления. ("Окно > Прочие> Конструктор стилей CSS")
* *"Предварительный просмотр CSS": *окно предварительного просмотра, в котором при помещении курсора внутри правила отображается стандартный текст, соответствующий блоку объявления этого правила. ("Окно > Прочие> Предварительный просмотр CSS")
-* *Редактор правил стиля: *диалоговое окно, позволяющее создавать правила на основе классов, идентификаторов и элементов HTML и определять их положение в иерархии документа. Кнопка ('Создать правило' ( image::images/style-rule-editor-btn.png[] ), расположенная в верхнем левом углу панели инструментов редактора CSS)
+* *Редактор правил стиля: *диалоговое окно, позволяющее создавать правила на основе классов, идентификаторов и элементов HTML и определять их положение в иерархии документа. Кнопка ('Создать правило' ( image:images/style-rule-editor-btn.png[] ), расположенная в верхнем левом углу панели инструментов редактора CSS)
В среде IDE NetBeans 6.9 предоставляется поддержка функций "Реорганизация в связи с переименованием" и "Поиск использований". Эта поддержка доступна не только в файлах CSS, но и во всех файлах, содержащих внедренный код CSS (например, HTML и PHP). Классы CSS, идентификаторы и элементы типов могут реорганизовываться во всех файлах проекта. Для использования поддержки реорганизации нажмите сочетание клавиш CTRL+R внутри элемента CSS и в появившемся диалоговом окне выполните переименование. [...]
@@ -940,7 +999,9 @@ a:hover {
Выполните проверку кода CSS, щелкнув редактор CSS правой кнопкой мыши и выбрав команду "Проверить CSS". В окне "Вывод" можно просмотреть все ошибки ("Окно" > "Вывод").
-5. Перейдите к странице `index.php` в редакторе и добавьте справочную информацию в таблицу стилей между тегами `<head>`.
+
+[start=5]
+. Перейдите к странице `index.php` в редакторе и добавьте справочную информацию в таблицу стилей между тегами `<head>`.
[source,java]
----
@@ -948,7 +1009,9 @@ a:hover {
<link rel="stylesheet" type="text/css" href="stylesheet.css">
----
-6. Выполните проект еще раз. В браузере отображается страница-указатель с созданной таблицей стилей. При каждом вводе символа на сервер передается асинхронный запрос, который возвращается с данными XML, подготовленными при помощи `AutoCompleteServlet`. При вводе последующих символов количество вариантов имен композиторов уменьшается, и на экране появляется новый список соответствий.
+
+[start=6]
+. Выполните проект еще раз. В браузере отображается страница-указатель с созданной таблицей стилей. При каждом вводе символа на сервер передается асинхронный запрос, который возвращается с данными XML, подготовленными при помощи `AutoCompleteServlet`. При вводе последующих символов количество вариантов имен композиторов уменьшается, и на экране появляется новый список соответствий.
diff --git a/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart_zh_CN.asciidoc
index b433237..91e14ba 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/ajax-quickstart_zh_CN.asciidoc
@@ -51,11 +51,12 @@ image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 Net
|link:http://httpd.apache.org/download.cgi[+Apache Web 服务器+] |2.2
|===
-*注：*
-
+[NOTE]
+====
* PHP 开发环境通常使用 *AMP 包进行配置，具体取决于您的操作系统。该环境包括 PHP 引擎和 Apache Web 服务器。有关配置环境的说明，请参见 link:../../trails/php.html[+PHP 学习资源+]。
* 本教程假设您已经具备它所使用的各种技术（即 HTML、CSS、JavaScript 和 PHP）的应用知识。它尝试以代码的形式提供功能的概述，但_不_解释每行代码的含义。
* 如果需要将项目与工作解决方案进行比较，可以link:https://netbeans.org/projects/samples/downloads/download/Samples%252FPHP%252FMyAjaxApp.zip[+下载样例应用程序+]。使用 IDE 的新建项目向导（Ctrl-Shift-N 组合键；在 Mac 上为 ⌘-Shift-N 组合键），并选择 "PHP with Existing Sources"（基于现有源代码的 PHP 应用程序）项目类型。在该向导中，指向计算机上已下载的源文件。
+====
@@ -89,21 +90,34 @@ image::images/ajax-process-flow.png[title="Ajax 过程流图"]
1. 选择 "File"（文件）> "New Project"（新建项目）。在 "Categories"（类别）下，选择 *PHP*。在 "Projects"（项目）下，选择 *PHP Application*（PHP 应用程序），然后单击 *Next*（下一步）。
2. 在“步骤 2：Name and Location（名称和位置）”中，将项目命名为 `MyAjaxApp`。使用 "Sources Folder"（源文件夹）字段可以在计算机上指定项目的位置。将其他选项保留为默认设置，然后单击 *Next*（下一步）。
+
image::images/php-name-location.png[title="新建 PHP 项目向导 - "Name and Location"（名称和位置）面板"]
-3. 在步骤 3 "Run Configuration"（运行配置）中，指定您要部署应用程序的方式。如果您已通过配置 *AMP 包设置了 PHP 开发环境，则应该从下拉列表中选择 *Local Web Site*（本地 Web 站点），并指定项目的 URL（将显示在浏览器中）。
-4. 选中 "Copy files from Sources Folder to another location"（将源文件夹中的文件复制到其他位置）选项。然后，在 "Copy to Folder "（复制到文件夹）字段中，键入到服务器上部署位置的路径。（在 Apache 上，部署位置是默认的 `htdocs` 目录。）
+
+
+[start=3]
+. 在步骤 3 "Run Configuration"（运行配置）中，指定您要部署应用程序的方式。如果您已通过配置 *AMP 包设置了 PHP 开发环境，则应该从下拉列表中选择 *Local Web Site*（本地 Web 站点），并指定项目的 URL（将显示在浏览器中）。
+
+[start=4]
+. 选中 "Copy files from Sources Folder to another location"（将源文件夹中的文件复制到其他位置）选项。然后，在 "Copy to Folder "（复制到文件夹）字段中，键入到服务器上部署位置的路径。（在 Apache 上，部署位置是默认的 `htdocs` 目录。）
+
[.feature]
--
image::images/php-run-config.png[role="left", link="images/php-run-config.png"]
--
-5. 单击 *Finish*（完成）。IDE 在您的文件系统中创建项目文件夹，项目在 IDE 中打开。
+
+
+[start=5]
+. 单击 *Finish*（完成）。IDE 在您的文件系统中创建项目文件夹，项目在 IDE 中打开。
您也可以使用项目向导 将框架支持添加到项目中（可在向导的步骤 4 中执行该操作）。
生成默认的 `index.php` 索引页并在 IDE 的编辑器中将其打开。您的项目还会显示在 "Projects"（项目）窗口中。
image::images/php-proj-win.png[title=""Projects"（项目）窗口将显示 MyAjaxApp 项目"]
-6. 在开始编码前，请立即尝试运行该应用程序以确保正确设置了 IDE、您的服务器和浏览器之间的配置。
+
+
+[start=6]
+. 在开始编码前，请立即尝试运行该应用程序以确保正确设置了 IDE、您的服务器和浏览器之间的配置。
在 IDE 的编辑器中，向索引页中添加一个 `echo` 语句：
@@ -116,9 +130,11 @@ image::images/php-proj-win.png[title=""Projects"（项目）窗口将显示 MyAj
?>
----
-7. 在 "Projects"（项目）窗口中，右键单击项目节点，然后选择 "Run"（运行）。IDE 会打开您的默认浏览器，并显示您刚在 `index.php` 中创建的 Hello World 消息。
-*注：*如果您在设置项目或在 IDE、服务器和浏览器之间建立通信时遇到困难，请参见link:project-setup.html[+设置 PHP 项目+]以获取更详细的说明。link:../../trails/php.html[+PHP 学习资源+]可以提供有关配置环境的更多信息。
+[start=7]
+. 在 "Projects"（项目）窗口中，右键单击项目节点，然后选择 "Run"（运行）。IDE 会打开您的默认浏览器，并显示您刚在 `index.php` 中创建的 Hello World 消息。
+
+NOTE: 如果您在设置项目或在 IDE、服务器和浏览器之间建立通信时遇到困难，请参见link:project-setup.html[+设置 PHP 项目+]以获取更详细的说明。link:../../trails/php.html[+PHP 学习资源+]可以提供有关配置环境的更多信息。
[[html]]
@@ -156,7 +172,9 @@ image::images/palette.png[title="显示 HTML 元素的 "Palette"（组件面板
</html>
----
-4. 添加一些说明性文本以介绍文本字段的用途。您可以复制以下文本并将其粘贴在 `<h1>` 标记下方的某一位置：
+
+[start=4]
+. 添加一些说明性文本以介绍文本字段的用途。您可以复制以下文本并将其粘贴在 `<h1>` 标记下方的某一位置：
[source,html]
----
@@ -169,16 +187,21 @@ image::images/palette.png[title="显示 HTML 元素的 "Palette"（组件面板
then click on one of the selections to see composer details.</p>
----
-5. 向该页面中添加一个 HTML 窗体。可以利用 IDE "Palette"（组件面板）中列出的元素执行此操作。如果组件面板没有打开，请从主菜单中选择 "Window"（窗口）> "Palette"（组件面板）。然后，在 "HTML Forms"（HTML 窗体）下，单击某个窗体元素，并将其拖至该页面中您刚添加的 `<p>` 标记下的某一位置。此时将打开 "Insert Form"（插入窗体）对话框。指定以下内容：
+
+[start=5]
+. 向该页面中添加一个 HTML 窗体。可以利用 IDE "Palette"（组件面板）中列出的元素执行此操作。如果组件面板没有打开，请从主菜单中选择 "Window"（窗口）> "Palette"（组件面板）。然后，在 "HTML Forms"（HTML 窗体）下，单击某个窗体元素，并将其拖至该页面中您刚添加的 `<p>` 标记下的某一位置。此时将打开 "Insert Form"（插入窗体）对话框。指定以下内容：
* "Action"（操作）：autocomplete.php
* "Method"（方法）：GET
* "Name"（名称）：autofillform
+
image::images/php-insert-form.png[title=""Insert form"（插入窗体）对话框"]
单击 "OK"（确定）。HTML `<form>` 标记已插入到包含您所指定的属性的页面中。（GET 在默认情况下应用，因此没有进行显式声明。）
-6. 向该页面添加一个 HTML 表格。在 "Palette"（组件面板）中的 "HTML" 类别下，单击某个表格元素，并将其拖至 `<form>` 标记之间的位置。"Insert Table"（插入表格）对话框即打开。指定以下内容：
+
+[start=6]
+. 向该页面添加一个 HTML 表格。在 "Palette"（组件面板）中的 "HTML" 类别下，单击某个表格元素，并将其拖至 `<form>` 标记之间的位置。"Insert Table"（插入表格）对话框即打开。指定以下内容：
* "Rows"（行）：2
* "Columns"（列）：2
@@ -186,8 +209,12 @@ image::images/php-insert-form.png[title=""Insert form"（插入窗体）对话
* "Width"（宽度）：0
* "Cell Spacing"（单元格间距）：0
* "Cell Padding"（单元格边距）：5
+
image::images/insert-table.png[title=""Insert table"（插入表格）对话框"]
-7. 在源代码编辑器中单击鼠标右键，然后选择 "Format"（格式化代码）。此操作将对代码进行整理。现在，您的窗体应该如下显示：
+
+
+[start=7]
+. 在源代码编辑器中单击鼠标右键，然后选择 "Format"（格式化代码）。此操作将对代码进行整理。现在，您的窗体应该如下显示：
[source,xml]
----
@@ -214,14 +241,18 @@ image::images/insert-table.png[title=""Insert table"（插入表格）对话框"
</form>
----
-8. 将以下文本键入到此表格第一行的第一列中（更改的内容以*粗体*显示）：
+
+[start=8]
+. 将以下文本键入到此表格第一行的第一列中（更改的内容以*粗体*显示）：
[source,xml]
----
<td>*<strong>Composer Name:</strong>*</td>
----
-9. 在第一行的第二列中，手动键入以下代码（而不从 "Palette"（组件面板）中拖动一个文本输入字段）。
+
+[start=9]
+. 在第一行的第二列中，手动键入以下代码（而不从 "Palette"（组件面板）中拖动一个文本输入字段）。
[source,java]
----
@@ -233,13 +264,20 @@ image::images/insert-table.png[title=""Insert table"（插入表格）对话框"
----
在键入时，请尝试使用 IDE 内置的代码完成支持。例如，键入 `<i`，然后按 Ctrl-空格组合键。建议的选项列表会显示在光标下方，并且选中元素的说明会显示在上方的框中。事实上，在源代码编辑器中编写代码时，可以随时按 Ctrl-空格键调出可能的选项。而且，如果只有一个可用的选项，按 Ctrl-空格键将自动完成元素名称。
-image::images/code-completion.png[title="在源代码编辑器中按 Ctrl-空格键可以触发代码完成"]
+image:images/code-completion.png[title="在源代码编辑器中按 Ctrl-空格键可以触发代码完成"]
您在上文中键入的 `onkeyup` 属性指向名为 `doCompletion()` 的 JavaScript 函数。每次在窗体文本字段中按下一个键时，此函数都会被调用，并映射到以上 Ajax <<flow-diagram,流程图>>中所描述的 JavaScript 调用。
-10. 在转为使用 JavaScript 编辑器之前，请将应用程序的入口点由 `index.php` 文件替换为新的 `index.html` 文件。
-要执行此操作，请右键单击 "Projects"（项目）窗口中的项目节点，然后选择 "Properties"（属性）。选择 *Run Configuration*（运行配置）类别，然后在 "Index File"（索引文件）字段中输入 `index.html`。image::images/php-entry-point.png[title="在 "Project Properties"（项目属性）窗口中指定应用程序的入口点"]
-11. 单击 "OK"（确定）以保存更改，然后退出 "Project Properties"（项目属性）窗口。
-12. 运行该项目以查看其在浏览器中的外观。单击 "Run Project"（运行项目）(image::images/run-project-btn.png[]) 按钮。在默认浏览器中显示 `index.html` 文件。
+[start=10]
+. 在转为使用 JavaScript 编辑器之前，请将应用程序的入口点由 `index.php` 文件替换为新的 `index.html` 文件。
+
+要执行此操作，请右键单击 "Projects"（项目）窗口中的项目节点，然后选择 "Properties"（属性）。选择 *Run Configuration*（运行配置）类别，然后在 "Index File"（索引文件）字段中输入 `index.html`。image:images/php-entry-point.png[title="在 "Project Properties"（项目属性）窗口中指定应用程序的入口点"]
+
+[start=11]
+. 单击 "OK"（确定）以保存更改，然后退出 "Project Properties"（项目属性）窗口。
+
+[start=12]
+. 运行该项目以查看其在浏览器中的外观。单击 "Run Project"（运行项目）(image:images/run-project-btn.png[]) 按钮。在默认浏览器中显示 `index.html` 文件。
+
image::images/index-page.png[title="运行项目以在浏览器中查看其当前状态"]
@@ -294,7 +332,9 @@ function initRequest() {
以上代码将对 Firefox 3 以及 Internet Explorer 版本 6 和 7 执行简单的浏览器兼容性检查。如果希望包含更多强健的代码以处理兼容性问题，建议您使用 link:http://www.quirksmode.org[+http://www.quirksmode.org+] 中的link:http://www.quirksmode.org/js/detect.html[+浏览器检测脚本+]。
-4. 切换回 `index.html`，然后在 `<head>` 标记之间添加对 JavaScript 文件的引用。
+
+[start=4]
+. 切换回 `index.html`，然后在 `<head>` 标记之间添加对 JavaScript 文件的引用。
[source,xml]
----
@@ -305,7 +345,9 @@ function initRequest() {
您可以按 Ctrl-Tab 组合键在编辑器中打开的页面之间快速切换。
-5. 在开始标记 `<body>` 中，插入对 `init()` 的调用。
+
+[start=5]
+. 在开始标记 `<body>` 中，插入对 `init()` 的调用。
[source,java]
----
@@ -418,7 +460,9 @@ class ComposerData {
}
----
-4. 在编辑器中，将以下代码粘贴到该类（更改内容以*粗体*显示）。
+
+[start=4]
+. 在编辑器中，将以下代码粘贴到该类（更改内容以*粗体*显示）。
[source,php]
----
@@ -502,9 +546,15 @@ class ComposerData {
实现用于处理由传入请求接收的 `autocomplete` URL 的逻辑。为此，请修改现有的 `index.php` 文件，而不是使用上一部分所述的文件向导来创建新 PHP 文件。
1. 在 "Projects"（项目）窗口中，单击 `index.php` 文件节点。文件名变为可编辑状态，以便您修改其名称。
+
image::images/edit-file-name.png[title="单击文件节点可编辑名称"]
-2. 将该文件命名为 `autocomplete`，然后单击 Enter 键。双击新的 `autocomplete.php` 文件，使其显示在编辑器中。
-3. 将该文件的现有代码替换为以下脚本。
+
+
+[start=2]
+. 将该文件命名为 `autocomplete`，然后单击 Enter 键。双击新的 `autocomplete.php` 文件，使其显示在编辑器中。
+
+[start=3]
+. 将该文件的现有代码替换为以下脚本。
[source,php]
----
@@ -571,7 +621,7 @@ if(isset($_GET['action']) && isset($_GET['id']) && $_GET['action
?>
----
-*注：*本教程中未描述文件 composerView.php。您可以创建这样的文件来查看搜索的最终结果。link:https://netbeans.org/projects/samples/downloads/download/Samples%252FPHP%252FMyAjaxApp.zip[+样例应用程序+]中包含了此文件的样例。
+NOTE: 本教程中未描述文件 composerView.php。您可以创建这样的文件来查看搜索的最终结果。link:https://netbeans.org/projects/samples/downloads/download/Samples%252FPHP%252FMyAjaxApp.zip[+样例应用程序+]中包含了此文件的样例。
正如您看到的，编写用于进行 Ajax 处理的服务器端的代码时并没有什么真正的新内容要了解。如果希望交换 XML 文档，则需要将响应内容类型设置为 `text/xml`。通过 Ajax，您还可以交换纯文本，甚至可以交换可在客户端由回调函数计算或执行的 JavaScript 片段。还请注意，有些浏览器可能会缓存结果，因此可能需要将 Cache-Control HTTP 头信息设置为 `no-cache`。
@@ -662,7 +712,7 @@ function callback() {
`parseMessages()` 函数用于处理传入的 XML 数据。为了实现此功能，它需要依靠若干附属的函数，如 `appendComposer()`、`getElementY()` 和 `clearTable()`。您还必须向此索引页引入新的元素（如用作自动完成框的另一个 HTML 表格），以及元素的 ID，以便它们可以在 `javascript.js` 中引用。最后，创建对应于 `index.php` 中元素 ID 的新变量，并且在之前实现的 `init()` 函数中对其进行初始化，然后添加每次加载 `index.php` 时所需要的一些功能。
-*注：*您在以下步骤中创建的函数和元素之间存在相互依赖关系。建议您完成此部分，然后在代码全部完成之后检查此代码。
+NOTE: 您在以下步骤中创建的函数和元素之间存在相互依赖关系。建议您完成此部分，然后在代码全部完成之后检查此代码。
1. 在编辑器中打开 `index.html`，并在您之前创建的 HTML 表格的第二行键入以下代码。
@@ -676,7 +726,9 @@ function callback() {
</tr>
----
此新行（可以标识为 "`auto-row`"）用作 JavaScript 代码的处理程序，以便插入一个新 HTML 表，该表将形成自动完成框。
-2. 在编辑器中打开 `javascript.js`，并在文件顶部添加以下三个变量。
+
+[start=2]
+. 在编辑器中打开 `javascript.js`，并在文件顶部添加以下三个变量。
[source,java]
----
@@ -685,7 +737,9 @@ var completeField;
var completeTable;
var autoRow;
----
-3. 将以下行（以*粗体*显示）添加到 `init()` 函数中。
+
+[start=3]
+. 将以下行（以*粗体*显示）添加到 `init()` 函数中。
[source,java]
----
@@ -711,7 +765,9 @@ function init() {
<td/>
</tr>
----
-4. 将 `appendComposer()` 添加到 `javascript.js`。
+
+[start=4]
+. 将 `appendComposer()` 添加到 `javascript.js`。
[source,java]
----
@@ -744,7 +800,9 @@ function appendComposer(firstName,lastName,composerId) {
}
----
此函数创建了一个新的表行，并用其所含的三个参数传递的数据将指向作曲家的链接插入此表行中，然后将此行插入索引页的 `complete-table` 元素中。
-5. 将 `clearTable()` 添加到 `javascript.js`。
+
+[start=5]
+. 将 `clearTable()` 添加到 `javascript.js`。
[source,java]
----
@@ -759,7 +817,9 @@ function clearTable() {
}
----
此函数用于将 `complete-table` 元素的显示方式设置为 "none"（无）（也就是使其不可见），并删除所有已创建的现有作曲家名字条目。
-6. 将 `getElementY()` 添加到 `javascript.js`。
+
+[start=6]
+. 将 `getElementY()` 添加到 `javascript.js`。
[source,java]
----
@@ -781,9 +841,11 @@ function getElementY(element){
----
此函数用于查找父元素的垂直位置。这是必要的，因为此元素的实际位置（如果显示）通常根据浏览器的类型和版本而定。请注意，如果 `complete-table` 元素显示包含作曲家名字，则会移动到其所在表格中的右下角。正确的高度定位由 `getElementY()` 确定。
-*注：*请在 link:http://www.quirksmode.org/[+http://www.quirksmode.org/+] 上查看 `offset` 的link:http://www.quirksmode.org/js/findpos.html[+说明+]。
+NOTE: 请在 link:http://www.quirksmode.org/[+http://www.quirksmode.org/+] 上查看 `offset` 的link:http://www.quirksmode.org/js/findpos.html[+说明+]。
+
-7. 修改 `callback()` 函数以便每次从服务器接收到新数据时都调用 `clearTable()`。因此，在用新条目填充自动完成框之前其中已存在的任何作曲家条目均会删除。
+[start=7]
+. 修改 `callback()` 函数以便每次从服务器接收到新数据时都调用 `clearTable()`。因此，在用新条目填充自动完成框之前其中已存在的任何作曲家条目均会删除。
[source,java]
----
@@ -799,7 +861,9 @@ function callback() {
}
}
----
-8. 将 `parseMessages()` 添加到 `javascript.js`。
+
+[start=8]
+. 将 `parseMessages()` 添加到 `javascript.js`。
[source,java]
----
@@ -853,14 +917,14 @@ function parseMessages(responseXML) {
在此阶段，您已完成了实现此应用程序功能所需的所有代码。要查看您的努力成果，请立即尝试运行此应用程序。
-1. 运行该项目以查看其在浏览器中的外观。单击 "Run Project"（运行项目）(image::images/run-project-btn.png[]) 按钮。在浏览器中显示 `index.html` 文件。
-image::images/no-css.png[title="不带样式表的成功部署"]
+1. 运行该项目以查看其在浏览器中的外观。单击 "Run Project"（运行项目）(image:images/run-project-btn.png[]) 按钮。在浏览器中显示 `index.html` 文件。
+image:images/no-css.png[title="不带样式表的成功部署"]
要在应用程序中附加一个样式表，只需创建 CSS（Cascading Style Sheet，级联样式表）文件，并从表示页面链接到此文件即可。当您使用 CSS 文件时，IDE 会为您提供代码完成支持，以及其他一些有助于生成样式表规则的功能。其中包括：
* *CSS 样式构建器：*此界面旨在让您可以使用所选的控件和窗口部件创建规则。（"Window"（窗口）> "Other"（其他）> "CSS Style Builder"（CSS 样式构建器））
* *CSS 预览：*如果您将光标置于某个规则中，此预览窗口就会显示根据此规则的声明块所呈现的样例文本。（"Window"（窗口）> "Other"（其他）> "CSS Preview"（CSS 预览））
-* *样式规则编辑器：*通过此对话框，您可以基于类、ID 和 HTML 元素创建规则，并在文档分层结构中设置其位置。（位于 CSS 编辑器工具栏左上角区域的 "Create Rule"（创建规则）(image::images/style-rule-editor-btn.png[]) 按钮）
+* *样式规则编辑器：*通过此对话框，您可以基于类、ID 和 HTML 元素创建规则，并在文档分层结构中设置其位置。（位于 CSS 编辑器工具栏左上角区域的 "Create Rule"（创建规则）(image:images/style-rule-editor-btn.png[]) 按钮）
NetBeans 6.9 提供了“重命名重构”和“查找使用实例”支持。此支持不仅可用于 css 文件，而且也可用于包含嵌入 CSS 代码的所有文件（例如，HTML、PHP）。在所有项目文件中，均可重构 CSS 类、id 和类型元素。要使用此重构支持，请在给定 CSS 元素上按 Ctrl-R 组合键，然后使用提供的对话框执行重命名操作。在执行重命名操作之前，也可以预览更改。要使用“查找使用实例”支持，请右键单击 CSS 元素，然后选择 "Find Usages"（查找使用实例）。有关更多详细信息，请参见 link:http://wiki.netbeans.org/wiki/index.php?title=NewAndNoteworthy69m1§ion=T-25#Web_Languages[+NewAndNoteworthy69m1+]。
@@ -940,7 +1004,9 @@ a:hover {
对 CSS 代码的有效性执行检查，方法是右键单击 CSS 编辑器，然后选择 "Check CSS"（检查 CSS）。遇到的任何错误都会显示在 "Output"（输出）窗口中（"Windows"（窗口）> "Output"（输出））。
-5. 切换到编辑器中的 `index.html` 页（按 Ctrl-Tab 组合键），然后在 `<head>` 标记之间添加对样式表的引用。
+
+[start=5]
+. 切换到编辑器中的 `index.html` 页（按 Ctrl-Tab 组合键），然后在 `<head>` 标记之间添加对样式表的引用。
[source,java]
----
@@ -948,7 +1014,9 @@ a:hover {
<link rel="stylesheet" type="text/css" href="stylesheet.css">
----
-6. 再次运行应用程序。将使用您刚创建的样式表在浏览器中显示索引页。每次您键入字符时，都会向服务器发送异步请求，并返回 `autocomplete.php` 准备好的 XML 数据。随着您输入的字符增多，为了反映匹配项的新列表，作曲家名字的数量会越来越少。
+
+[start=6]
+. 再次运行应用程序。将使用您刚创建的样式表在浏览器中显示索引页。每次您键入字符时，都会向服务器发送异步请求，并返回 `autocomplete.php` 准备好的 XML 数据。随着您输入的字符增多，为了反映匹配项的新列表，作曲家名字的数量会越来越少。
diff --git a/netbeans.apache.org/src/content/kb/docs/php/code-templates.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/code-templates.asciidoc
index ff0d789..2416e30 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/code-templates.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/code-templates.asciidoc
@@ -69,12 +69,18 @@ When the abbreviation for a template is also part of a keyword for code completi
*Caution:* Spell the abbreviation correctly! Expansion does not work if you misspell the abbreviation.
image::images/expanding-template-with-abb.png[]
-3. The placeholder class name ( ``*class_name*`` ) is selected automatically. You can move between placeholders by pressing Tab. You can immediately type the name you want for the class and this name overwrites the placeholder. Press Enter when you are done and the IDE selects the name of the first function, which in this case is the constructor.
-*Note: *Placeholder names are discussed in more detail in the <<placeholder,Placeholder name section>>.
+
+[start=3]
+. The placeholder class name ( ``*class_name*`` ) is selected automatically. You can move between placeholders by pressing Tab. You can immediately type the name you want for the class and this name overwrites the placeholder. Press Enter when you are done and the IDE selects the name of the first function, which in this case is the constructor.
+
+NOTE: Placeholder names are discussed in more detail in the <<placeholder,Placeholder name section>>.
image::images/select-constructor-name.png[]
-4. Edit the function name or accept the default. Press Enter again, and the cursor moves to the inside of the function's body. In a real world scenario, you would now start coding the function and the rest of the class.
+
+
+[start=4]
+. Edit the function name or accept the default. Press Enter again, and the cursor moves to the inside of the function's body. In a real world scenario, you would now start coding the function and the rest of the class.
The final position of the cursor is determined by the ``${cursor}`` parameter. This parameter is described in the section <<reserved-name,Reserved names>>.
@@ -87,11 +93,21 @@ To insert a code template by using code completion, type the beginning of the ex
1. In the PHP block of a PHP file, type ``cla`` .
2. Wait for the code completion dialog to open.
3. Locate the new class template, which is listed with its abbreviation ( ``cls`` ). The PHPDoc frame shows the expanded template.
+
image::images/insert-template-with-cc.png[]
-4. Select the new class template and press Enter. The IDE inserts it into your code.
-5. The placeholder class name ( ``*class_name*`` ) is selected automatically. You can move between placeholders by pressing Tab. You can immediately type the name you want for the class and this name overwrites the placeholder. Press Enter when you are done and the IDE selects the name of the first function, which in this case is the constructor.
+
+
+[start=4]
+. Select the new class template and press Enter. The IDE inserts it into your code.
+
+[start=5]
+. The placeholder class name ( ``*class_name*`` ) is selected automatically. You can move between placeholders by pressing Tab. You can immediately type the name you want for the class and this name overwrites the placeholder. Press Enter when you are done and the IDE selects the name of the first function, which in this case is the constructor.
+
image::images/select-constructor-name.png[]
-6. Edit the function name or accept the default. Press Enter again, and the cursor moves to the inside of the function's body. In a real world scenario, you would now start coding the function and the rest of the class.
+
+
+[start=6]
+. Edit the function name or accept the default. Press Enter again, and the cursor moves to the inside of the function's body. In a real world scenario, you would now start coding the function and the rest of the class.
== Surrounding code with a template
@@ -108,7 +124,7 @@ You can surround your code with the following PHP templates:
In addition, you can <<create,create a new template>> that can surround code if the template includes the `allowSurround` <<complex,parameter hint>>. (Hat tip to the link:http://www.mybelovedphp.com/2012/05/14/tips-for-using-the-netbeans-editor-for-kohana-and-kostache-mustache-templates-using-surround-with/[+ My Beloved PHP blog+].)
-To surround code with a template, select the code and open the Surround with... dialog. To open the Surround with... dialog, either press Alt-Enter or click the Hint image::images/hint-icon.png[] icon.
+To surround code with a template, select the code and open the Surround with... dialog. To open the Surround with... dialog, either press Alt-Enter or click the Hint image:images/hint-icon.png[] icon.
*To surround code with an if(true) template:*
@@ -117,26 +133,46 @@ To surround code with a template, select the code and open the Surround with...
[source,php]
----
-<?php$a = false;$b = 10;?>
+<?php
+ $a = false;
+ $b = 10;?
+>
----
-2. Select the line ``$b = 10;``
+
+[start=2]
+. Select the line ``$b = 10;``
+
image::images/selected-variable.png[]
-3. Click the Hint image::images/hint-icon.png[] icon or press Alt-Enter. The Surround with... dialog opens.
+
+
+[start=3]
+. Click the Hint image::images/hint-icon.png[] icon or press Alt-Enter. The Surround with... dialog opens.
+
image::images/surround-hint.png[]
-4. Click `` Surround with if{*true*){...``
+
+
+[start=4]
+. Click `` Surround with if{*true*){...``
+
image::images/surround-if-true.png[]
-5. The IDE surrounds the line ``$b = 10;`` with an ``if(*true*){... `` template.
+
+
+[start=5]
+. The IDE surrounds the line ``$b = 10;`` with an ``if(*true*){... `` template.
+
image::images/inserted-if-true.png[]
The IDE automatically inserts the nearest preceding suitable variable as the ``if`` statement's condition. In this case, that variable is ``$a`` , because ``$a`` is a boolean and the ``if(*true*){} `` statement takes a boolean variable as its condition. Furthermore, the condition is automatically selected for editing, in case the variable that the IDE inserts into the condition is not the correct variable. This means you can begin typing the correct variable immediately after the t [...]
-*Note: *The ``if(*true*){}`` template is described in detail in the section <<complex,Parameter defined by hints>>.
+NOTE: The ``if(*true*){}`` template is described in detail in the section <<complex,Parameter defined by hints>>.
image::images/change-condition.png[]
Press Enter to exit the statement's condition. The cursor moves to the appropriate location, which in this case is the end of the line ``$b = 10;`` . You can edit the condition and press Enter or accept the automatically inserted condition and press Enter. In either case the cursor exits the condition and moves to the appropriate location.
-image::images/cursor-after-not-editing.png[]image::images/cursor-after-editing.png[]
+image::images/cursor-after-not-editing.png[]
+
+image::images/cursor-after-editing.png[]
The next section contains more details about editing the parameters in expanded templates.
@@ -147,15 +183,25 @@ In the sections on inserting templates into your code, you saw how the IDE autom
*To simultaneously edit multiple instances of a parameter:*
1. In an empty PHP block, type ``for`` and press Ctrl-Space to open code completion. Select the iteration template (abbreviation ``iter`` ) and press Enter. A new iteration is inserted into your code.
+
image::images/iter-cc.png[]
-2. The iteration has two variables as parameters, ``$index`` and ``$array`` . ``$index`` is selected automatically for editing. (Pressing Tab moves between parameters.)
+
+
+[start=2]
+. The iteration has two variables as parameters, ``$index`` and ``$array`` . ``$index`` is selected automatically for editing. (Pressing Tab moves between parameters.)
+
image::images/iteration1.png[]
Type ``i`` . All three instances of ``$index`` change to ``$i`` .
image::images/iteration2.png[]
-3. Press Enter or Tab. The parameter ``$array`` is selected.
-4. Press Enter. The cursor enters the method body of the iteration.
+
+
+[start=3]
+. Press Enter or Tab. The parameter ``$array`` is selected.
+
+[start=4]
+. Press Enter. The cursor enters the method body of the iteration.
The variable name refactoring feature in NetBeans enables you to change all instances of a variable name by editing only one instance. You see here how this is helpful when applied to template parameters.
@@ -163,23 +209,37 @@ The NetBeans IDE PHP editor also helps identify the correct method for variables
*To associate a variable in a template with the correct method:*
-1. In an empty PHP block, type the follwing code:
+
+[start=1]
+. In an empty PHP block, type the follwing code:
[source,php]
----
-<?php$arr = array(new ArrayIterator($array()), new ArrayObject($array()));?>
+<?php
+ $arr = array(new ArrayIterator($array()), new ArrayObject($array()));?>
----
-2. After the line declaring the ``$arr`` array, type ``fore`` and use code completion to insert the `` foreach`` template (abbreviation: ``fore`` ).
+
+[start=2]
+. After the line declaring the ``$arr`` array, type ``fore`` and use code completion to insert the `` foreach`` template (abbreviation: ``fore`` ).
+
image::images/cc-foreach.png[]
-3. Place the cursor in the body of the ``foreach`` function (you can press Enter twice to move the cursor there) and type ``$value`` , or only type ``$`` and select ``$value`` from code completion.
+
+
+[start=3]
+. Place the cursor in the body of the ``foreach`` function (you can press Enter twice to move the cursor there) and type ``$value`` , or only type ``$`` and select ``$value`` from code completion.
[source,php]
----
-<?php$arr = array(new ArrayIterator($array()), new ArrayObject($array()));foreach ($arr as $value) {$value}?>
+<?php
+ $arr = array(new ArrayIterator($array()), new ArrayObject($array()));
+ foreach ($arr as $value) {$value}?>
----
-4. After ``$value`` , type ``->`` . Code completion offers you the correct methods for the ``$value`` variable, which is derived from the array ``$arr`` .
+
+[start=4]
+. After ``$value`` , type ``->`` . Code completion offers you the correct methods for the ``$value`` variable, which is derived from the array ``$arr`` .
+
image::images/value-method-cc.png[]
== PHP Code Template Syntax
@@ -220,10 +280,11 @@ The IDE reserves two parameter names for use as operating instructions.
For example, again consider the new class template ``(cls)`` that this tutorial shows in the sections <<define,Defined PHP Templates>> and <<expand-with-abb,Expanding the code template by using the abbreviation + Tab>>. It contains two placeholder name parameters, ``${ClassName}`` and ``$__construct`` . In the function body, it has the parameters ``${cursor}`` and ``${selection}`` .
-[source,java]
+[source,php]
----
-class ${ClassName} {function ${__construct} {${selection}${cursor}}}
+class ${ClassName} {
+ function ${__construct} {${selection}${cursor}}}
----
After the template expands, the placeholder ``*class_name*`` is selected automatically (1). Press Enter, and the placeholder ``*__construct*`` is selected automatically (2). There are no other values to edit. Press Enter again, and the cursor moves to the location indicated by ``${cursor}`` in the template's text (3).
@@ -237,7 +298,7 @@ image::images/cursor-position-changes.png[]
Parameters can consist of an arbitrary, descriptive name in ALL-CAPS and one or more hints.
-[source,java]
+[source,php]
----
${PARAMETER_NAME hint1[=value] [hint2...hint n]}
@@ -247,7 +308,7 @@ The name does not appear anywhere in the code. However, it is useful if you want
-[source,java]
+[source,php]
----
$$${CONLINK newVarName default="link"} = mysql_connect('localhost', 'mysql_user', 'mysql_password'); if (!$$${CONLINK}) { die('Could not connect: ' . mysql_error()); } echo 'Connected successfully'; mysql_close($$${CONLINK}); ${cursor}
@@ -256,7 +317,7 @@ $$${CONLINK newVarName default="link"} = mysql_connect('localhost', 'mysql_us
Hints help the IDE to compute the value of the template parameter when the IDE expands the code template. For example, look at the ``if(*true*)`` template, which is used in this tutorial in the section on <<surround-code,surrounding your code with a template>>. The expanded text of this template is
-[source,java]
+[source,php]
----
if (${CONDITION variableFromPreviousAssignment instanceof="boolean" default="true"}) {${selection}${cursor}}
@@ -302,12 +363,20 @@ You can create your own code templates in NetBeans IDE. This section tells you h
*To create a code template:*
1. Open Tools > Options (NetBeans > Preferences on Mac), select the Editor features, and select the Code Templates tab.
+
image::images/code-template-options.png[]
-2. Click New to open the New Code Template dialog box. Type in the abbreviation you want for the template and click OK.
+
+
+[start=2]
+. Click New to open the New Code Template dialog box. Type in the abbreviation you want for the template and click OK.
+
image::images/new-abb.png[]
-3. A new row is added to the table of code templates. This row contains only the abbreviation you provided. The cursor is in the Expanded Text tab, where the IDE placed the cursor automatically. You can begin typing the template's code immediately.
-*Note: *To learn about the syntax of the code template's expanded text, see the section <<syntax,PHP Code Template Syntax.>>
+
+[start=3]
+. A new row is added to the table of code templates. This row contains only the abbreviation you provided. The cursor is in the Expanded Text tab, where the IDE placed the cursor automatically. You can begin typing the template's code immediately.
+
+NOTE: To learn about the syntax of the code template's expanded text, see the section <<syntax,PHP Code Template Syntax.>>
image::images/new-abb-text.png[]
@@ -347,7 +416,7 @@ Code templates can help you use PHP frameworks in NetBeans IDE, especially frame
|Expanded text: |
-[source,java]
+[source,php]
----
defined('_JEXEC')or die('Restricted access');${cursor}
@@ -368,7 +437,7 @@ PHP developers often need to create a connection to a MySQL database. This code
|Expanded text: |
-[source,java]
+[source,php]
----
$$${CONLINK newVarName default="link"} = mysql_connect('localhost', 'mysql_user', 'mysql_password'); if (!$$${CONLINK}) { die('Could not connect: ' . mysql_error()); } echo 'Connected successfully'; mysql_close($$${CONLINK}); ${cursor}
@@ -390,7 +459,7 @@ Rather than use the NetBeans wizard for creating an action, you can use a code t
|Expanded text: |
-[source,java]
+[source,php]
----
public function ${functionName}Action () {${selection}${cursor} }
@@ -412,11 +481,13 @@ This template inserts an element into a Zend form. Use it after you generate a f
|Expanded text: |
-[source,java]
+[source,php]
----
$$${ELEMENT newVarName default="element"} = new Zend_Form_Element_Submit('submit', array('label' => 'Send data to server')); $$this->addElement($$${ELEMENT}); ${cursor}
----
|===
+
image::images/uc-zelement.png[]
+
diff --git a/netbeans.apache.org/src/content/kb/docs/php/code-templates_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/code-templates_ja.asciidoc
index f708a0f..a5f5eeb 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/code-templates_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/code-templates_ja.asciidoc
@@ -32,9 +32,6 @@
コード・テンプレートは、NetBeans IDEによって提供される記述済のコード・スニペットです。コード補完を使用するか、またはテンプレートの省略名に続けて[Tab]キーを押すことによって、スニペットを自分のコードに貼り付けることができます。適切なPHPスニペットでコードを囲むこともできます。さらに、独自のコード・テンプレートも定義できます。このチュートリアルでは、コード・テンプレートの使用方法を解説し、独自のコード・スニペットを定義するために役立つケースを紹介します。
-image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、NetBeans IDE 7.2、7.3、7.4および8.0に適用されます"]
-
-
*このチュートリアルを完了するには、次のソフトウェアとリソースが必要です。*
|===
@@ -56,7 +53,7 @@ image::images/code-template-options.png[]
このイメージでは、新規クラス( ``cls`` )コード・テンプレートが選択され、「展開されるテキスト」タブにはテンプレートが展開されたときの内容が表示されています。次の項では、Tab機能を使用してコード内でこのテンプレートを展開します。
-*注意:* 新規クラス( ``cls`` )コード・テンプレートの構文については、<<syntax,PHPコード・テンプレートの構文>>の項で説明します。
+NOTE: 新規クラス( ``cls`` )コード・テンプレートの構文については、<<syntax,PHPコード・テンプレートの構文>>の項で説明します。
== PHPコード・テンプレートの使用方法
@@ -85,15 +82,21 @@ image::images/expand-template-on.png[]
1. 空のPHPファイルを作成します。
2. そのファイルのPHPブロックで、「 ``cls`` 」と入力して[Tab]を押します。 ``cls`` コード・テンプレートが展開されます。
-*注意:* 省略名のスペルを間違えないようにしてください。省略名のスペルが間違っていると展開は機能しません。
+NOTE: 省略名のスペルを間違えないようにしてください。省略名のスペルが間違っていると展開は機能しません。
image::images/expanding-template-with-abb.png[]
-3. プレースホルダのクラス名( ``*class_name*`` )が自動的に選択されます。[Tab]を押して、プレースホルダ間を移動できます。クラスに付ける名前をここで入力でき、入力した名前によってプレースホルダが上書きされます。終了して[Enter]を押すと、最初の関数(この場合はコンストラクタ)の名前がIDEで選択されます。
-*注意:* プレースホルダ名については<<placeholder,プレースホルダ名>>の項で詳しく説明します。
+
+[start=3]
+. プレースホルダのクラス名( ``*class_name*`` )が自動的に選択されます。[Tab]を押して、プレースホルダ間を移動できます。クラスに付ける名前をここで入力でき、入力した名前によってプレースホルダが上書きされます。終了して[Enter]を押すと、最初の関数(この場合はコンストラクタ)の名前がIDEで選択されます。
+
+NOTE: プレースホルダ名については<<placeholder,プレースホルダ名>>の項で詳しく説明します。
image::images/select-constructor-name.png[]
-4. 関数名を編集するか、またはデフォルトの名前をそのまま使用します。もう一度[Enter]を押すと、カーソルが関数本体の内部に移動します。実際には、ここで関数およびクラスの残り部分のコーディングを開始します。
+
+
+[start=4]
+. 関数名を編集するか、またはデフォルトの名前をそのまま使用します。もう一度[Enter]を押すと、カーソルが関数本体の内部に移動します。実際には、ここで関数およびクラスの残り部分のコーディングを開始します。
カーソルの最終位置は ``${cursor}`` パラメータによって決定されます。このパラメータについては<<reserved-name,予約名>>の項で説明します。
@@ -107,11 +110,21 @@ image::images/select-constructor-name.png[]
1. PHPファイルのPHPブロックで、「 ``cla`` 」と入力します。
2. コード補完ダイアログが表示されるまで待ちます。
3. 省略名( ``cls`` )とともに一覧表示される新規クラス・テンプレートを探します。PHPDocフレームには展開されたテンプレートが表示されます。
+
image::images/insert-template-with-cc.png[]
-4. 新規クラス・テンプレートを選択し、[Enter]キーを押します。IDEによって、コードに挿入されます。
-5. プレースホルダのクラス名( ``*class_name*`` )が自動的に選択されます。[Tab]を押して、プレースホルダ間を移動できます。クラスに付ける名前をここで入力でき、入力した名前によってプレースホルダが上書きされます。終了して[Enter]を押すと、最初の関数(この場合はコンストラクタ)の名前がIDEで選択されます。
+
+
+[start=4]
+. 新規クラス・テンプレートを選択し、[Enter]キーを押します。IDEによって、コードに挿入されます。
+
+[start=5]
+. プレースホルダのクラス名( ``*class_name*`` )が自動的に選択されます。[Tab]を押して、プレースホルダ間を移動できます。クラスに付ける名前をここで入力でき、入力した名前によってプレースホルダが上書きされます。終了して[Enter]を押すと、最初の関数(この場合はコンストラクタ)の名前がIDEで選択されます。
+
image::images/select-constructor-name.png[]
-6. 関数名を編集するか、またはデフォルトの名前をそのまま使用します。もう一度[Enter]を押すと、カーソルが関数本体の内部に移動します。実際には、ここで関数およびクラスの残り部分のコーディングを開始します。
+
+
+[start=6]
+. 関数名を編集するか、またはデフォルトの名前をそのまま使用します。もう一度[Enter]を押すと、カーソルが関数本体の内部に移動します。実際には、ここで関数およびクラスの残り部分のコーディングを開始します。
=== テンプレートでコードを囲む
@@ -129,7 +142,7 @@ image::images/select-constructor-name.png[]
また、テンプレートに`allowSurround`<<complex,パラメータ・ヒント>>が含まれている場合にコードを囲む<<create,新しいテンプレートを作成>>できます。(link:http://www.mybelovedphp.com/2012/05/14/tips-for-using-the-netbeans-editor-for-kohana-and-kostache-mustache-templates-using-surround-with/[+My Beloved PHPブログ+]に感謝します。)
-テンプレートでコードを囲むには、コードを選択して「囲む」ダイアログを開きます。「囲む」ダイアログを開くには、[Alt]-[Enter]を押すか、またはヒントimage::images/hint-icon.png[]・アイコンをクリックします。
+テンプレートでコードを囲むには、コードを選択して「囲む」ダイアログを開きます。「囲む」ダイアログを開くには、[Alt]-[Enter]を押すか、またはヒント image:images/hint-icon.png[]・アイコンをクリックします。
*if(true)テンプレートでコードを囲む*
@@ -140,24 +153,41 @@ image::images/select-constructor-name.png[]
<?php$a = false;$b = 10;?>
----
-2. 「 ``$b = 10;`` 」行を選択します。
+
+[start=2]
+. 「 ``$b = 10;`` 」行を選択します。
+
image::images/selected-variable.png[]
-3. ヒントimage::images/hint-icon.png[]・アイコンをクリックするか、[Alt]-[Enter]を押します。「囲む」ダイアログが開きます。
+
+
+[start=3]
+. ヒントimage::images/hint-icon.png[]・アイコンをクリックするか、[Alt]-[Enter]を押します。「囲む」ダイアログが開きます。
+
image::images/surround-hint.png[]
-4. 「 ``Surround with if{*true*){...`` 」をクリックします。
+
+
+[start=4]
+. 「 ``Surround with if{*true*){...`` 」をクリックします。
+
image::images/surround-if-true.png[]
-5. IDEで、「 ``$b=10;`` 」行が「 ``if(*true*){...`` 」テンプレートで囲まれます。
+
+
+[start=5]
+. IDEで、「 ``$b=10;`` 」行が「 ``if(*true*){...`` 」テンプレートで囲まれます。
+
image::images/inserted-if-true.png[]
IDEでは自動的に、出現済で最も近い位置にある適切な変数が ``if`` 文の条件として挿入されます。 ``$a`` はブール型であり、 ``if(*true*){}`` 文はその条件としてブール型の変数を取るため、この場合の該当する変数は ``$a`` です。また、IDEで条件に挿入された変数が正しい変数でない場合、その条件が自動的に編集のために選択されます。つまり、テンプレートが挿入された後、すぐに正しい変数の入力を開始できます。この場合、コード補完が正しい変数の選択に役立つことがあります。
-*注意:* ``if(*true*){}`` テンプレートについては、<<complex,ヒントによって定義されるパラメータ>>の項で詳しく説明します。
+NOTE: ``if(*true*){}`` テンプレートについては、<<complex,ヒントによって定義されるパラメータ>>の項で詳しく説明します。
image::images/change-condition.png[]
[Enter]を押して文の条件を終了します。カーソルが適切な位置(この場合は「 ``$b=10;`` 」行の末尾)に移動します。条件を編集して[Enter]を押すか、または自動挿入された条件を受け入れて[Enter]を押すことができます。どちらの場合でも、カーソルは条件から適切な位置に移動します。
-image::images/cursor-after-not-editing.png[]image::images/cursor-after-editing.png[]
+image::images/cursor-after-not-editing.png[]
+
+image::images/cursor-after-editing.png[]
次の項では、展開されたテンプレート内のパラメータの編集について詳しく説明します。
@@ -169,15 +199,25 @@ image::images/cursor-after-not-editing.png[]image::images/cursor-after-editing.p
*パラメータの複数のインスタンスを同時に編集する*
1. 空のPHPブロックで「 ``for`` 」と入力し、[Ctrl]-[Space]を押してコード補完を開きます。繰返し処理テンプレート(省略名 ``iter`` )を選択して[Enter]を押します。新しい繰返し処理がコードに挿入されます。
+
image::images/iter-cc.png[]
-2. 繰返し処理には、パラメータとして ``$index`` および ``$array`` の2つの変数があります。 ``$index`` が編集のために自動的に選択されます。([Tab]を押すと、パラメータ間を移動します。)
+
+
+[start=2]
+. 繰返し処理には、パラメータとして ``$index`` および ``$array`` の2つの変数があります。 ``$index`` が編集のために自動的に選択されます。([Tab]を押すと、パラメータ間を移動します。)
+
image::images/iteration1.png[]
「 ``i`` 」と入力します。 ``$index`` の3つのインスタンスがすべて ``$i`` に変更されます。
image::images/iteration2.png[]
-3. [Enter]または[Tab]を押します。パラメータ ``$array`` が選択されます。
-4. [Enter]を押します。カーソルが繰返し処理のメソッド本体に移動します。
+
+
+[start=3]
+. [Enter]または[Tab]を押します。パラメータ ``$array`` が選択されます。
+
+[start=4]
+. [Enter]を押します。カーソルが繰返し処理のメソッド本体に移動します。
NetBeansの変数名リファクタリング機能では、変数の1つのインスタンスを編集することにより、その変数のすべてのインスタンスを変更できます。これがテンプレートのパラメータに適用されると役に立つことがわかります。
@@ -192,16 +232,25 @@ NetBeans IDEのPHPエディタは、変数に対する正しいメソッドを
<?php$arr = array(new ArrayIterator($array()), new ArrayObject($array()));?>
----
-2. ``$arr`` 配列を宣言する行の後に「 ``fore`` 」と入力し、コード補完を使用して ``foreach`` テンプレート(省略名 ``fore`` )を挿入します。
+
+[start=2]
+. ``$arr`` 配列を宣言する行の後に「 ``fore`` 」と入力し、コード補完を使用して ``foreach`` テンプレート(省略名 ``fore`` )を挿入します。
+
image::images/cc-foreach.png[]
-3. ([Enter]を2回押すか、またはカーソルを移動して) ``foreach`` 関数の本体にカーソルを置き、「 ``$value`` 」と入力するか、または「 ``$`` 」とのみ入力してコード補完から「 ``$value`` 」を選択します。
+
+
+[start=3]
+. ([Enter]を2回押すか、またはカーソルを移動して) ``foreach`` 関数の本体にカーソルを置き、「 ``$value`` 」と入力するか、または「 ``$`` 」とのみ入力してコード補完から「 ``$value`` 」を選択します。
[source,php]
----
<?php$arr = array(new ArrayIterator($array()), new ArrayObject($array()));foreach ($arr as $value) {$value}?>
----
-4. 「 ``$value`` 」に続けて「 ``->`` 」と入力します。コード補完により、配列 ``$arr`` から派生した ``$value`` 変数に対する適切なメソッドが提示されます。
+
+[start=4]
+. 「 ``$value`` 」に続けて「 ``->`` 」と入力します。コード補完により、配列 ``$arr`` から派生した ``$value`` 変数に対する適切なメソッドが提示されます。
+
image::images/value-method-cc.png[]
@@ -220,7 +269,7 @@ PHPコード・テンプレートには、PHPコードとテンプレート・
後続の各項では、コード・テンプレート・パラメータの各形式について説明します。
-*注意:* ``$$${VARIABLE...}`` PHPコード・テンプレートの構文が、 ``$$${...}`` のように3つのドル記号に中括弧が続く形式になっている場合があります。この場合、コード・テンプレートには変数とその名前が含まれています。ここで示す構文では、エスケープされたドル記号(二重のドル記号 ``$$`` として記述される)に、変数名に対応するパラメータ ``${VARIABLE...}`` を続いています。たとえば、コード・テンプレート「 ``catch${Exception}$$${exc}`` 」は「[examplecode]# ``catch Exception$exc`` #」に展開されます。
+NOTE: ``$$${VARIABLE...}`` PHPコード・テンプレートの構文が、 ``$$${...}`` のように3つのドル記号に中括弧が続く形式になっている場合があります。この場合、コード・テンプレートには変数とその名前が含まれています。ここで示す構文では、エスケープされたドル記号(二重のドル記号 ``$$`` として記述される)に、変数名に対応するパラメータ ``${VARIABLE...}`` を続いています。たとえば、コード・テンプレート「 ``catch${Exception}$$${exc}`` 」は「[examplecode]# ``catch Exception$exc`` #」に展開されます。
=== プレースホルダ名
@@ -244,7 +293,7 @@ IDEでは、処理指示として使用される2つのパラメータ名が予
たとえば、このチュートリアルの<<define,定義済PHPテンプレート>>および<<expand-with-abb,省略名と[Tab]を使用したコード・テンプレートの展開>>の各項で示した新規クラス・テンプレート( ``cls`` )について再度考えてみます。 ``${ClassName}`` および ``$__construct`` という2つのプレースホルダ名パラメータが含まれています。関数本体には、 ``${cursor}`` および ``${selection}`` というパラメータが含まれています。
-[source,java]
+[source,php]
----
class ${ClassName} {function ${__construct} {${selection}${cursor}}}
@@ -261,7 +310,7 @@ image::images/cursor-position-changes.png[]
パラメータは、すべて大文字の任意の記述名と1つ以上のヒントで構成できます。
-[source,java]
+[source,php]
----
${PARAMETER_NAME hint1[=value] [hint2...hint n]}
@@ -271,7 +320,7 @@ ${PARAMETER_NAME hint1[=value] [hint2...hint n]}
-[source,java]
+[source,php]
----
$$${CONLINK newVarName default="link"} = mysql_connect('localhost', 'mysql_user', 'mysql_password'); if (!$$${CONLINK}) { die('Could not connect: ' . mysql_error()); } echo 'Connected successfully'; mysql_close($$${CONLINK}); ${cursor}
@@ -280,7 +329,7 @@ $$${CONLINK newVarName default="link"} = mysql_connect('localhost', 'mysql_us
ヒントは、IDEでコード・テンプレートが展開されるときにテンプレート・パラメータの値を計算するために参照されます。たとえば、このチュートリアルの<<surround-code,テンプレートでコードを囲む>>の項で使用される ``if(*true*)`` テンプレートを見てみます。このテンプレートの展開されたテキストは次のとおりです。
-[source,java]
+[source,php]
----
if (${CONDITION variableFromPreviousAssignment instanceof="boolean" default="true"}) {${selection}${cursor}}
@@ -326,12 +375,20 @@ NetBeans IDEで独自のコード・テンプレートを作成できます。
*コード・テンプレートを作成する*
1. 「ツール」>「オプション」(Macでは「NetBeans」>「プリファレンス」)を開き、「エディタ」機能を選択し、「コード・テンプレート」タブを選択します。
+
image::images/code-template-options.png[]
-2. 「新規」をクリックして、「新規コード・テンプレート」ダイアログ・ボックスを開きます。テンプレートの省略名を入力して「OK」をクリックします。
+
+
+[start=2]
+. 「新規」をクリックして、「新規コード・テンプレート」ダイアログ・ボックスを開きます。テンプレートの省略名を入力して「OK」をクリックします。
+
image::images/new-abb.png[]
-3. コード・テンプレートの表に新しい行が追加されます。この行の内容は、指定した省略名のみです。IDEで「展開されるテキスト」タブにカーソルが自動的に移動します。テンプレートのコードの入力をすぐに開始できます。
-*注意:* コード・テンプレートの展開されるテキストの構文については、<<syntax,PHPコード・テンプレートの構文>>の項を参照してください。
+
+[start=3]
+. コード・テンプレートの表に新しい行が追加されます。この行の内容は、指定した省略名のみです。IDEで「展開されるテキスト」タブにカーソルが自動的に移動します。テンプレートのコードの入力をすぐに開始できます。
+
+NOTE: コード・テンプレートの展開されるテキストの構文については、<<syntax,PHPコード・テンプレートの構文>>の項を参照してください。
image::images/new-abb-text.png[]
@@ -373,7 +430,7 @@ image::images/uc-php.png[]
|展開されるテキスト: |
-[source,java]
+[source,php]
----
defined('_JEXEC')or die('Restricted access');${cursor}
@@ -395,7 +452,7 @@ PHP開発者はしばしば、MySQLデータベースへの接続を作成する
|展開されるテキスト: |
-[source,java]
+[source,php]
----
$$${CONLINK newVarName default="link"} = mysql_connect('localhost', 'mysql_user', 'mysql_password'); if (!$$${CONLINK}) { die('Could not connect: ' . mysql_error()); } echo 'Connected successfully'; mysql_close($$${CONLINK}); ${cursor}
@@ -417,7 +474,7 @@ NetBeansのウィザードを使用してアクションを作成するかわり
|展開されるテキスト: |
-[source,java]
+[source,php]
----
public function ${functionName}Action () {${selection}${cursor} }
@@ -439,13 +496,14 @@ image::images/uc-zfact.png[]
|展開されるテキスト: |
-[source,java]
+[source,php]
----
$$${ELEMENT newVarName default="element"} = new Zend_Form_Element_Submit('submit', array('label' => 'Send data to server')); $$this->addElement($$${ELEMENT}); ${cursor}
----
|===
+
image::images/uc-zelement.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/php/code-templates_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/code-templates_pt_BR.asciidoc
index 51eb806..2b0be56 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/code-templates_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/code-templates_pt_BR.asciidoc
@@ -32,9 +32,6 @@
Os modelos de código são snippets pré-escritos de código fornecidos pelo NetBeans IDE. Você pode colar um snippet no código utilizando a funcionalidade autocompletar código ou a abreviação do modelo seguida da tecla Tab. Você também pode incluir o código entre snippets apropriados de PHP. Finalmente, você pode definir seus próprios modelos de código. Este tutorial mostra como utilizar os modelos de código e sugere casos úteis para definição de seus próprios modelos de código.
-image::images/netbeans-stamp-80-74-73.png[title="O conteúdo desta página se aplica ao NetBeans IDE 7.2, 7.3, 7.4 e 8.0"]
-
-
*Para concluir este tutorial, você precisa dos seguintes recursos e softwares.*
|===
@@ -56,7 +53,7 @@ image::images/code-template-options.png[]
Nesta imagem, o novo modelo de código classe ( ``cls)`` está selecionado e na guia Texto Expandido você vê como fica o modelo quando está expandido. Na próxima seção, você usa a função Tab para expandir este modelo no código.
-*Observação:* a sintaxe do novo modelo de código classe ( ``cls`` ) é explorada na seção <<syntax,Sintaxe do Modelo de Código PHP>>.
+NOTE: a sintaxe do novo modelo de código classe ( ``cls`` ) é explorada na seção <<syntax,Sintaxe do Modelo de Código PHP>>.
== Usando Modelos de Código PHP
@@ -88,12 +85,18 @@ Quando a abreviatura de um modelo também fizer parte de uma palavra-chave da fu
*Advertência:* digite corretamente a abreviação! A expansão não funcionará, caso a abreviação esteja mal escrita.
image::images/expanding-template-with-abb.png[]
-3. O nome de classe do placeholder ( ``*class_name*`` ) é selecionado automaticamente. Você pode mover-se entre os placeholders pressionando Tab. Você pode digitar imediatamente o nome desejado para a classe e este nome substitui o placeholder. Pressione Enter quando tiver terminado e o IDE selecionará o nome da primeira função, que neste caso é o construtor.
-*Observação: *os nomes do placeholder são abordados com mais detalhes na <<placeholder,seção Nome do Placeholder>>.
+
+[start=3]
+. O nome de classe do placeholder ( ``*class_name*`` ) é selecionado automaticamente. Você pode mover-se entre os placeholders pressionando Tab. Você pode digitar imediatamente o nome desejado para a classe e este nome substitui o placeholder. Pressione Enter quando tiver terminado e o IDE selecionará o nome da primeira função, que neste caso é o construtor.
+
+NOTE: os nomes do placeholder são abordados com mais detalhes na <<placeholder,seção Nome do Placeholder>>.
image::images/select-constructor-name.png[]
-4. Edite o nome da função ou aceite o default. Pressione Enter novamente e o cursor irá para dentro do corpo da função. Em uma situação real, você poderia agora começar a codificar a função e o resto da classe.
+
+
+[start=4]
+. Edite o nome da função ou aceite o default. Pressione Enter novamente e o cursor irá para dentro do corpo da função. Em uma situação real, você poderia agora começar a codificar a função e o resto da classe.
A posição final do cursor é determinada pelo parâmetro ``${cursor}`` . Este parâmetro será descrito na seção <<reserved-name,Nomes Reservados>>.
@@ -107,11 +110,21 @@ Para inserir um modelo de código utilizando a função autocompletar código, d
1. Digite ``cla`` no bloco PHP de um arquivo PHP.
2. Espere que a caixa de diálogo da função autocompletar código seja aberta.
3. Localize o novo modelo de classe, que está listado com a abreviação ( ``cls`` ). O quadro do PHPDoc mostra o modelo expandido.
+
image::images/insert-template-with-cc.png[]
-4. Selecione o novo modelo de classe e pressione Enter. O IDE o insere no código.
-5. O nome de classe do placeholder ( ``*class_name*`` ) é selecionado automaticamente. Você pode mover-se entre os placeholders pressionando Tab. Você pode digitar imediatamente o nome desejado para a classe e este nome substitui o placeholder. Pressione Enter quando tiver terminado e o IDE selecionará o nome da primeira função, que neste caso é o construtor.
+
+
+[start=4]
+. Selecione o novo modelo de classe e pressione Enter. O IDE o insere no código.
+
+[start=5]
+. O nome de classe do placeholder ( ``*class_name*`` ) é selecionado automaticamente. Você pode mover-se entre os placeholders pressionando Tab. Você pode digitar imediatamente o nome desejado para a classe e este nome substitui o placeholder. Pressione Enter quando tiver terminado e o IDE selecionará o nome da primeira função, que neste caso é o construtor.
+
image::images/select-constructor-name.png[]
-6. Edite o nome da função ou aceite o default. Pressione Enter novamente e o cursor irá para dentro do corpo da função. Em uma situação real, você poderia agora começar a codificar a função e o resto da classe.
+
+
+[start=6]
+. Edite o nome da função ou aceite o default. Pressione Enter novamente e o cursor irá para dentro do corpo da função. Em uma situação real, você poderia agora começar a codificar a função e o resto da classe.
=== Incluindo o código em um modelo
@@ -129,7 +142,7 @@ Você pode incluir o código nos seguintes modelos de PHP:
Além disso, você pode <<create,criar um novo modelo>> que pode circundar o código, se o modelo incluir `allowSurround` <<complex,parameter hint>>. (Dica para o link:http://www.mybelovedphp.com/2012/05/14/tips-for-using-the-netbeans-editor-for-kohana-and-kostache-mustache-templates-using-surround-with/[+ Blog My Beloved PHP+].)
-Para circundar o código com um modelo, selecione o código e abra a caixa de diálogo Circundar com... Para abrir a caixa de diálogo Circundar com..., pressione Alt-Enter ou clique no ícone Dica image::images/hint-icon.png[].
+Para circundar o código com um modelo, selecione o código e abra a caixa de diálogo Circundar com... Para abrir a caixa de diálogo Circundar com..., pressione Alt-Enter ou clique no ícone Dica image:images/hint-icon.png[].
*Para circundar o código em um modelo if(true):*
@@ -140,24 +153,41 @@ Para circundar o código com um modelo, selecione o código e abra a caixa de di
<?php$a = false;$b = 10;?>
----
-2. Selecione a linha ``$b = 10;``
+
+[start=2]
+. Selecione a linha ``$b = 10;``
+
image::images/selected-variable.png[]
-3. Clique no ícone Dica image::images/hint-icon.png[] ou pressione Alt-Enter. A caixa de diálogo Circundar com... será aberta.
+
+
+[start=3]
+. Clique no ícone Dica image::images/hint-icon.png[] ou pressione Alt-Enter. A caixa de diálogo Circundar com... será aberta.
+
image::images/surround-hint.png[]
-4. Clique em ``Circundar com if{*true*){...``
+
+
+[start=4]
+. Clique em ``Circundar com if{*true*){...``
+
image::images/surround-if-true.png[]
-5. O IDE circunda a linha ``$b = 10;`` com um modelo ``if(*true*){...`` .
+
+
+[start=5]
+. O IDE circunda a linha ``$b = 10;`` com um modelo ``if(*true*){...`` .
+
image::images/inserted-if-true.png[]
O IDE insere automaticamente a variável apropriada precedente mais próxima como a condição da instrução ``if`` . Neste caso, essa variável é ``$a`` , porque ``$a`` é um booliana e a instrução ``if(*true*){}`` toma uma variável booliana como sua condição. Além disso, a condição é selecionada automaticamente para edição caso a variável que o IDE insira na condição não seja a variável correta. Isso significa que você pode começar a digitar a variável correta imediatamente depois que o [...]
-*Observação: *o modelo ``if(*true*){}`` é descrito com detalhes na seção <<complex,Parâmetro definido por dicas>>.
+NOTE: o modelo ``if(*true*){}`` é descrito com detalhes na seção <<complex,Parâmetro definido por dicas>>.
image::images/change-condition.png[]
Pressione Enter para sair da condição de instrução. O cursor se desloca para o local apropriado, que neste caso é o fim da linha ``$b = 10;`` . Você pode editar a condição e pressionar Enter ou aceitar a condição inserida automaticamente e pressionar Enter. Em qualquer um dos casos, o cursor sai da condição e se desloca para o local apropriado.
-image::images/cursor-after-not-editing.png[]image::images/cursor-after-editing.png[]
+image::images/cursor-after-not-editing.png[]
+
+image::images/cursor-after-editing.png[]
A próxima seção contém mais detalhes sobre a edição de parâmetros nos modelos expandidos.
@@ -169,15 +199,25 @@ Nas seções sobre inserção de modelos no código, você viu como o IDE seleci
*Para editar simultaneamente várias instâncias de um parâmetro:*
1. Em um bloco PHP vazio, digite ``for`` e pressione Ctrl-Espaço para abrir a funcionalidade autocompletar código. Selecione o modelo de iteração (abreviação ``iter`` ) e pressione Enter. Uma nova iteração será inserida no seu código.
+
image::images/iter-cc.png[]
-2. A iteração tem duas variáveis como parâmetros, ``$index`` e ``$array`` . ``$index`` é selecionada automaticamente para edição. (Pressionando Tab elas são movidas entre os parâmetros.)
+
+
+[start=2]
+. A iteração tem duas variáveis como parâmetros, ``$index`` e ``$array`` . ``$index`` é selecionada automaticamente para edição. (Pressionando Tab elas são movidas entre os parâmetros.)
+
image::images/iteration1.png[]
Digite ``i`` . Todas as três instâncias de ``$index`` mudam para ``$i`` .
image::images/iteration2.png[]
-3. Pressione Enter ou Tab. O parâmetro ``$array`` é selecionado.
-4. Pressione Enter. O cursor insere o corpo do método da iteração.
+
+
+[start=3]
+. Pressione Enter ou Tab. O parâmetro ``$array`` é selecionado.
+
+[start=4]
+. Pressione Enter. O cursor insere o corpo do método da iteração.
A funcionalidade de refatoração do nome da variável no NetBeans permite alterar todas as instâncias de nome da variável editando somente uma instância. Aqui você pode ver como essa funcionalidade é útil quando aplicada nos parâmetros do modelo.
@@ -192,16 +232,25 @@ O editor PHP do NetBeans IDE também ajuda a identificar o método correto para
<?php$arr = array(new ArrayIterator($array()), new ArrayObject($array()));?>
----
-2. Depois da linha que declara o array ``$arr`` , digite ``fore`` e use a funcionalidade de autocompletar código para inserir o modelo ``foreach`` (abreviação: ``fore`` ).
+
+[start=2]
+. Depois da linha que declara o array ``$arr`` , digite ``fore`` e use a funcionalidade de autocompletar código para inserir o modelo ``foreach`` (abreviação: ``fore`` ).
+
image::images/cc-foreach.png[]
-3. Coloque o cursor no corpo da função ``foreach`` (você pode pressionar Enter duas vezes para tirar o cursor de lá) e digite ``$value`` , ou digite somente ``$`` e selecione ``$value`` na funcionalidade autocompletar código.
+
+
+[start=3]
+. Coloque o cursor no corpo da função ``foreach`` (você pode pressionar Enter duas vezes para tirar o cursor de lá) e digite ``$value`` , ou digite somente ``$`` e selecione ``$value`` na funcionalidade autocompletar código.
[source,php]
----
<?php$arr = array(new ArrayIterator($array()), new ArrayObject($array()));foreach ($arr as $value) {$value}?>
----
-4. Depois de ``$value`` , digite ``->`` . A funcionalidade autocompletar código oferece os métodos corretos para a variável ``$value`` , que se deriva do array ``$arr`` .
+
+[start=4]
+. Depois de ``$value`` , digite ``->`` . A funcionalidade autocompletar código oferece os métodos corretos para a variável ``$value`` , que se deriva do array ``$arr`` .
+
image::images/value-method-cc.png[]
@@ -220,7 +269,7 @@ A sintaxe de um parâmetro de modelo de código é um cifrão, ``$`` , seguido
As seções a seguir abordam cada uma das formas de um parâmetro de modelo de código.
-*Observação:* ``$$${VARIABLE...} `` às vezes, é exibido um modelo de código PHP no qual a sintaxe parece ser três cifrões seguidos das chaves ``$$${...}`` . Neste caso, o modelo de código inclui uma variável e seu nome. A sintaxe aqui é um cifrão com escape, escrito como dois cifrões ``$$`` , seguido de um parâmetro do nome da variável, ``${VARIABLE...}`` . Por exemplo, o modelo de código ``catch ${Exception} $$${exc}`` é expandido como [examplecode]# ``catch Exception $exc`` #.
+NOTE: ``$$${VARIABLE...} `` às vezes, é exibido um modelo de código PHP no qual a sintaxe parece ser três cifrões seguidos das chaves ``$$${...}`` . Neste caso, o modelo de código inclui uma variável e seu nome. A sintaxe aqui é um cifrão com escape, escrito como dois cifrões ``$$`` , seguido de um parâmetro do nome da variável, ``${VARIABLE...}`` . Por exemplo, o modelo de código ``catch ${Exception} $$${exc}`` é expandido como [examplecode]# ``catch Exception $exc`` #.
=== Nome do placeholder
@@ -244,7 +293,7 @@ O IDE reserva dois nomes de parâmetros para serem utilizados como instruções
Por exemplo, novamente examine o novo modelo de classe ``(cls)`` que este tutorial mostra nas seções <<define,Modelos de PHP Definidos >> e <<expand-with-abb,Expandindo o modelo de código usando abreviação + Tab>>. Ele contém dois parâmetros de nome do placeholder ``${ClassName}`` e ``$__construct`` . No corpo da função, há os parâmetros ``${cursor}`` e ``${selection}`` .
-[source,java]
+[source,php]
----
class ${ClassName} {function ${__construct} {${selection}${cursor}}}
@@ -261,7 +310,7 @@ image::images/cursor-position-changes.png[]
Os parâmetros podem ter um nome arbitrário e descritivo em MAIÚSCULAS e uma ou mais dicas.
-[source,java]
+[source,php]
----
${PARAMETER_NAME hint1[=value] [hint2...hint n]}
@@ -271,7 +320,7 @@ O nome não aparece em nenhum lugar do código. No entanto, é útil se você qu
-[source,java]
+[source,php]
----
$$${CONLINK newVarName default="link"} = mysql_connect('localhost', 'mysql_user', 'mysql_password'); if (!$$${CONLINK}) { die('Could not connect: ' . mysql_error()); } echo 'Connected successfully'; mysql_close($$${CONLINK}); ${cursor}
@@ -280,7 +329,7 @@ $$${CONLINK newVarName default="link"} = mysql_connect('localhost', 'mysql_us
As dicas ajudam o IDE a calcular o valor do parâmetro do modelo quando o IDE expande o modelo de código. Veja, por exemplo, o modelo ``if(*true*)`` , utilizado neste tutorial na seção <<surround-code,circundando o código com um modelo>>. O texto expandido deste modelo é
-[source,java]
+[source,php]
----
if (${CONDITION variableFromPreviousAssignment instanceof="boolean" default="true"}) {${selection}${cursor}}
@@ -326,12 +375,20 @@ Você também pode criar seus próprios modelos de código no NetBeans IDE. Esta
*Para criar um modelo de código:*
1. Abra Ferramentas > Opções (NetBeans > Preferências no Mac), selecione as funcionalidades do Editor e selecione a guia Modelos de Código.
+
image::images/code-template-options.png[]
-2. Clique em Novo para abrir a caixa de diálogo Novo Modelo de Código. Digite a abreviação que deseja para o modelo e clique em OK.
+
+
+[start=2]
+. Clique em Novo para abrir a caixa de diálogo Novo Modelo de Código. Digite a abreviação que deseja para o modelo e clique em OK.
+
image::images/new-abb.png[]
-3. É adicionada uma nova linha à tabela de modelos de código. Esta linha contém somente a abreviação fornecida. O cursor está na guia Texto Expandido, onde o IDE colocou o cursor automaticamente. Você pode começar a digitar imediatamente o código do modelo.
-*Observação: *para saber mais sobre a sintaxe do texto expandido do modelo de código, consulte a seção <<syntax,Sintaxe do Modelo de Código PHP.>>
+
+[start=3]
+. É adicionada uma nova linha à tabela de modelos de código. Esta linha contém somente a abreviação fornecida. O cursor está na guia Texto Expandido, onde o IDE colocou o cursor automaticamente. Você pode começar a digitar imediatamente o código do modelo.
+
+NOTE: para saber mais sobre a sintaxe do texto expandido do modelo de código, consulte a seção <<syntax,Sintaxe do Modelo de Código PHP.>>
image::images/new-abb-text.png[]
@@ -373,7 +430,7 @@ Os modelos de código podem ajudá-lo a utilizar os frameworks PHP no NetBeans I
|Texto expandido: |
-[source,java]
+[source,php]
----
defined('_JEXEC')or die('Restricted access');${cursor}
@@ -395,7 +452,7 @@ Os desenvolvedores de PHP precisam geralmente criar uma conexão com um banco de
|Texto expandido: |
-[source,java]
+[source,php]
----
$$${CONLINK newVarName default="link"} = mysql_connect('localhost', 'mysql_user', 'mysql_password'); if (!$$${CONLINK}) { die('Could not connect: ' . mysql_error()); } echo 'Connected successfully'; mysql_close($$${CONLINK}); ${cursor}
@@ -417,7 +474,7 @@ Em vez de utilizar o assistente do NetBeans para criar uma ação, você pode ut
|Texto expandido: |
-[source,java]
+[source,php]
----
public function ${functionName}Action () {${selection}${cursor} }
@@ -439,7 +496,7 @@ Este modelo insere um elemento em um form Zend. Use-o depois de gerar um form ch
|Texto expandido: |
-[source,java]
+[source,php]
----
$$${ELEMENT newVarName default="element"} = new Zend_Form_Element_Submit('submit', array('label' => 'Send data to server')); $$this->addElement($$${ELEMENT}); ${cursor}
diff --git a/netbeans.apache.org/src/content/kb/docs/php/code-templates_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/code-templates_ru.asciidoc
index 4967b28..994a9d4 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/code-templates_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/code-templates_ru.asciidoc
@@ -56,7 +56,7 @@ image::images/code-template-options.png[]
В примере на рисунке выбран шаблон кода нового класса ( ``cls)`` , а на вкладке "Расширенный текст" отображается развернутый шаблон. В следующем разделе описывается использование клавиши TAB для развертывания шаблона в коде.
-*Примечание.* Синтаксис нового шаблона кода класса ( ``cls`` ) описывается в разделе <<syntax,Синтаксис шаблона кода PHP>>.
+NOTE: Синтаксис нового шаблона кода класса ( ``cls`` ) описывается в разделе <<syntax,Синтаксис шаблона кода PHP>>.
== Использование шаблонов кода PHP
@@ -88,12 +88,18 @@ image::images/expand-template-on.png[]
*Внимание!* Аббревиатуру необходимо ввести корректно! В случае ошибок при вводе шаблон не будет развернут.
image::images/expanding-template-with-abb.png[]
-3. Имя класса метки-заполнителя ( ``*class_name*`` ) выбирается автоматически. Для перехода от одного заполнителя к другому можно использовать клавишу Tab. Можно сразу указать требуемое имя класса, которое будет перезаписано для метки-заполнителя. После завершения ввода нажмите ENTER. В среде IDE будет выбрано имя первой функции, которой в данном варианте является конструктор.
-*Примечание: * Имена заменителей описываются более детально в разделе <<placeholder,Раздел имен заменителей>>.
+
+[start=3]
+. Имя класса метки-заполнителя ( ``*class_name*`` ) выбирается автоматически. Для перехода от одного заполнителя к другому можно использовать клавишу Tab. Можно сразу указать требуемое имя класса, которое будет перезаписано для метки-заполнителя. После завершения ввода нажмите ENTER. В среде IDE будет выбрано имя первой функции, которой в данном варианте является конструктор.
+
+NOTE: Имена заменителей описываются более детально в разделе <<placeholder,Раздел имен заменителей>>.
image::images/select-constructor-name.png[]
-4. Отредактируйте имя функции или примите значение по умолчанию. Затем снова нажмите ENTER. Курсор переместится в тело функции. В реальном сценарии после этого начинается кодирование функции и остального класса.
+
+
+[start=4]
+. Отредактируйте имя функции или примите значение по умолчанию. Затем снова нажмите ENTER. Курсор переместится в тело функции. В реальном сценарии после этого начинается кодирование функции и остального класса.
Итоговое положение курсора определяется параметром ``${cursor}`` . Этот параметр описывается в разделе <<reserved-name,Зарезервированные имена>>.
@@ -107,11 +113,21 @@ image::images/select-constructor-name.png[]
1. Введите в блоке PHP файла PHP значение ``cla`` .
2. Дождитесь открытия диалогового окна дополнения кода.
3. Выполните поиск шаблона нового класса, рядом с которым указана аббревиатура ( ``cls`` ). Развернутый шаблон отображается в рамке PHPDoc.
+
image::images/insert-template-with-cc.png[]
-4. Выберите шаблон нового класса и нажмите Enter. В среде IDE выполняется его вставка в код.
-5. Имя класса метки-заполнителя ( ``*class_name*`` ) выбирается автоматически. Для перехода от одного заполнителя к другому можно использовать клавишу Tab. Можно сразу указать требуемое имя класса, которое будет перезаписано для метки-заполнителя. После завершения ввода нажмите ENTER. В среде IDE будет выбрано имя первой функции, которой в данном варианте является конструктор.
+
+
+[start=4]
+. Выберите шаблон нового класса и нажмите Enter. В среде IDE выполняется его вставка в код.
+
+[start=5]
+. Имя класса метки-заполнителя ( ``*class_name*`` ) выбирается автоматически. Для перехода от одного заполнителя к другому можно использовать клавишу Tab. Можно сразу указать требуемое имя класса, которое будет перезаписано для метки-заполнителя. После завершения ввода нажмите ENTER. В среде IDE будет выбрано имя первой функции, которой в данном варианте является конструктор.
+
image::images/select-constructor-name.png[]
-6. Отредактируйте имя функции или примите значение по умолчанию. Затем снова нажмите ENTER. Курсор переместится в тело функции. В реальном сценарии после этого начинается кодирование функции и остального класса.
+
+
+[start=6]
+. Отредактируйте имя функции или примите значение по умолчанию. Затем снова нажмите ENTER. Курсор переместится в тело функции. В реальном сценарии после этого начинается кодирование функции и остального класса.
=== Добавление шаблона вокруг кода
@@ -129,7 +145,7 @@ image::images/select-constructor-name.png[]
Кроме того, можно <<create,создать новый шаблон>>, который будет окружать код, если шаблон включает в себя <<complex,подсказку параметра>> `allowSurround`. (Выражаем благодарность за предоставленную информацию авторам блога link:http://www.mybelovedphp.com/2012/05/14/tips-for-using-the-netbeans-editor-for-kohana-and-kostache-mustache-templates-using-surround-with/[+ My Beloved PHP+].)
-Чтобы добавить шаблон вокруг кода, выберите код и откройте диалоговое окно "Окружение...". Чтобы открыть диалоговое окно 'Окружить...', нажмите Alt-Enter или щелкните значок 'Подсказка' image::images/hint-icon.png[].
+Чтобы добавить шаблон вокруг кода, выберите код и откройте диалоговое окно "Окружение...". Чтобы открыть диалоговое окно 'Окружить...', нажмите Alt-Enter или щелкните значок 'Подсказка' image:images/hint-icon.png[].
*Для добавления шаблона if(true) вокруг кода выполните следующее:*
@@ -140,24 +156,41 @@ image::images/select-constructor-name.png[]
<?php$a = false;$b = 10;?>
----
-2. Выберите строку ``$b = 10;``
+
+[start=2]
+. Выберите строку ``$b = 10;``
+
image::images/selected-variable.png[]
-3. Нажмите на значок 'Подсказка' image::images/hint-icon.png[] или нажмите Alt-Enter. Откроется диалоговое окно "Окружение...".
+
+
+[start=3]
+. Нажмите на значок 'Подсказка' image::images/hint-icon.png[] или нажмите Alt-Enter. Откроется диалоговое окно "Окружение...".
+
image::images/surround-hint.png[]
-4. Щелкните `` Surround with if{*true*){...``
+
+
+[start=4]
+. Щелкните `` Surround with if{*true*){...``
+
image::images/surround-if-true.png[]
-5. В среде IDE строка ``$b = 10;`` будет окружена шаблоном ``if(*true*){... `` .
+
+
+[start=5]
+. В среде IDE строка ``$b = 10;`` будет окружена шаблоном ``if(*true*){... `` .
+
image::images/inserted-if-true.png[]
В среде IDE в качестве условия оператора ``if`` автоматически вставляется ближайшая предшествующая допустимая переменная. В данном варианте используется переменная ``$a`` , поскольку ``$a`` является логическим значением, а условие оператора ``if(*true*){} `` подразумевает логическую переменную. Более того, если переменная, вставленная в среде IDE в условие, неправильна, это условие автоматически выделяется для редактирования. Это означает, что ввод корректной переменной можно начат [...]
-*Примечание *. Шаблон ``if(*true*){}`` описывается подробно в разделе <<complex,Параметр, определяемый подсказками>>.
+NOTE: . Шаблон ``if(*true*){}`` описывается подробно в разделе <<complex,Параметр, определяемый подсказками>>.
image::images/change-condition.png[]
Для выхода из условия оператора нажмите ENTER. Курсор переместится в соответствующее местоположение, в данном случае — в конец строки ``$b = 10;`` . Пользователь может отредактировать условие и нажать ENTER или принять автоматически подставляемое условие, после чего нажать ENTER. В любом случае курсор будет перемещен из условия в соответствующее местоположение.
-image::images/cursor-after-not-editing.png[]image::images/cursor-after-editing.png[]
+image::images/cursor-after-not-editing.png[]
+
+image::images/cursor-after-editing.png[]
В следующем разделе редактирование параметров в развернутых шаблонах описано более подробно.
@@ -169,15 +202,25 @@ image::images/cursor-after-not-editing.png[]image::images/cursor-after-editing.p
*Одновременное редактирование нескольких экземпляров параметра:*
1. В пустом блоке PHP введите ``for`` и нажмите сочетание клавиш CTRL+ПРОБЕЛ для открытия дополнения кода. Выберите шаблон итерации (аббревиатура ``iter`` ) и нажмите Enter. В код будет вставлена новая итерация.
+
image::images/iter-cc.png[]
-2. В итерации в качестве параметров используются две переменных: ``$index`` и ``$array`` . Переменная ``$index`` выбирается для редактирования автоматически. (Для перемещения между параметрами используйте клавишу Tab.)
+
+
+[start=2]
+. В итерации в качестве параметров используются две переменных: ``$index`` и ``$array`` . Переменная ``$index`` выбирается для редактирования автоматически. (Для перемещения между параметрами используйте клавишу Tab.)
+
image::images/iteration1.png[]
Введите ``i`` . Все три экземпляра параметра ``$index`` изменятся на ``$i`` .
image::images/iteration2.png[]
-3. Нажмите Enter или Tab. Будет выбран параметр ``$array`` .
-4. Нажмите ENTER. Курсор переместится в тело метода итерации.
+
+
+[start=3]
+. Нажмите Enter или Tab. Будет выбран параметр ``$array`` .
+
+[start=4]
+. Нажмите ENTER. Курсор переместится в тело метода итерации.
Функция реорганизации имен переменных в NetBeans позволяет изменить все экземпляры имени переменной путем редактирования только одного экземпляра. В данном разделе рассматривается ее использование для параметров шаблона.
@@ -192,16 +235,25 @@ image::images/iteration2.png[]
<?php$arr = array(new ArrayIterator($array()), new ArrayObject($array()));?>
----
-2. После строки с объявлением массива ``$arr`` введите ``fore`` и с помощью дополнения кода вставьте шаблон `` foreach`` (аббревиатура: ``fore`` ).
+
+[start=2]
+. После строки с объявлением массива ``$arr`` введите ``fore`` и с помощью дополнения кода вставьте шаблон `` foreach`` (аббревиатура: ``fore`` ).
+
image::images/cc-foreach.png[]
-3. Поместите курсор в тело функции ``foreach`` (для перемещения курсора можно дважды нажать ENTER) и введите значение ``$value`` или введите только ``$`` и выберите ``$value`` из дополнения кода.
+
+
+[start=3]
+. Поместите курсор в тело функции ``foreach`` (для перемещения курсора можно дважды нажать ENTER) и введите значение ``$value`` или введите только ``$`` и выберите ``$value`` из дополнения кода.
[source,php]
----
<?php$arr = array(new ArrayIterator($array()), new ArrayObject($array()));foreach ($arr as $value) {$value}?>
----
-4. После ``$value`` введите ``->`` . Дополнение кода обеспечивает корректные методы для переменной ``$value`` , значение которой можно получить из массива ``$arr`` .
+
+[start=4]
+. После ``$value`` введите ``->`` . Дополнение кода обеспечивает корректные методы для переменной ``$value`` , значение которой можно получить из массива ``$arr`` .
+
image::images/value-method-cc.png[]
@@ -220,7 +272,7 @@ IDE NetBeans обеспечивает шаблоны кодов для всех
В следующих разделах рассматриваются все формы параметров шаблона кода.
-*Примечание.* ``$$${VARIABLE...} `` Иногда отображается шаблон кода PHP во фрагментах, где синтаксис состоит из трех знаков доллара, после которых стоят фигурные скобки ``$$${...}`` . В этом случае шаблон кода содержит переменную и ее имя. Здесь знак доллара пропущен, и в синтаксисе присутствует двойной знак доллара ``$$`` , за которым следует параметр имени переменной ``${VARIABLE...}`` . Например, шаблон кода ``catch ${Exception} $$${exc}`` расширяется как [examplecode]# ``catch [...]
+NOTE: ``$$${VARIABLE...} `` Иногда отображается шаблон кода PHP во фрагментах, где синтаксис состоит из трех знаков доллара, после которых стоят фигурные скобки ``$$${...}`` . В этом случае шаблон кода содержит переменную и ее имя. Здесь знак доллара пропущен, и в синтаксисе присутствует двойной знак доллара ``$$`` , за которым следует параметр имени переменной ``${VARIABLE...}`` . Например, шаблон кода ``catch ${Exception} $$${exc}`` расширяется как [examplecode]# ``catch Excepti [...]
=== Имя метки-заполнителя
@@ -244,7 +296,7 @@ image::images/expanding-template-with-abb.png[]
Например, обратитесь еще раз к шаблону нового класса ``(cls)`` , который рассматривается в разделах <<define,Заданные шаблоны кода PHP>> и <<expand-with-abb,Расширение шаблона кода путем использования аббревиатуры с нажатием клавиши Tab>> данного учебного курса. Он содержит два параметра-заполнителя имени, ``${ClassName}`` и ``$__construct`` . В теле функции содержатся параметры ``${cursor}`` и ``${selection}`` .
-[source,java]
+[source,php]
----
class ${ClassName} {function ${__construct} {${selection}${cursor}}}
@@ -261,7 +313,7 @@ image::images/cursor-position-changes.png[]
Параметр может содержать произвольное описательное имя В ВЕРХНЕМ РЕГИСТРЕ и одну или несколько подсказок.
-[source,java]
+[source,php]
----
${PARAMETER_NAME hint1[=value] [hint2...hint n]}
@@ -271,7 +323,7 @@ ${PARAMETER_NAME hint1[=value] [hint2...hint n]}
-[source,java]
+[source,php]
----
$$${CONLINK newVarName default="link"} = mysql_connect('localhost', 'mysql_user', 'mysql_password'); if (!$$${CONLINK}) { die('Could not connect: ' . mysql_error()); } echo 'Connected successfully'; mysql_close($$${CONLINK}); ${cursor}
@@ -280,7 +332,7 @@ $$${CONLINK newVarName default="link"} = mysql_connect('localhost', 'mysql_us
Подсказки в среде IDE используются для расчета значения параметра шаблона при развертывании шаблона кода. Рассмотрим шаблон ``if(*true*)`` , описанный в данном учебном курсе в разделе, посвященном <<surround-code,добавлению шаблона вокруг кода>>. В этом шаблоне развернутый текст выглядит следующим образом:
-[source,java]
+[source,php]
----
if (${CONDITION variableFromPreviousAssignment instanceof="boolean" default="true"}) {${selection}${cursor}}
@@ -326,12 +378,20 @@ image::images/inserted-if-true.png[]
*Для создания шаблона кода выполните следующее:*
1. Выберите команды "Средства" > "Параметры" ("NetBeans > Параметры" в системе Mac), перейдите к функциям редактора и откройте вкладку "Шаблоны кода".
+
image::images/code-template-options.png[]
-2. Нажмите 'Создать'. В результате откроется диалоговое окно 'Создание шаблона кода'. Введите аббревиатуру для шаблона и нажмите кнопку "ОК".
+
+
+[start=2]
+. Нажмите 'Создать'. В результате откроется диалоговое окно 'Создание шаблона кода'. Введите аббревиатуру для шаблона и нажмите кнопку "ОК".
+
image::images/new-abb.png[]
-3. В таблицу шаблонов кода будет добавлена новая строка. Она содержит только введенную аббревиатуру. Курсор будет автоматически расположен на вкладке "Расширенный текст". Код шаблона можно ввести прямо на этой вкладке.
-*Примечание. *Описание синтаксиса расширенного текста шаблона кода см. в разделе <<syntax,Синтаксис шаблона кода PHP.>>
+
+[start=3]
+. В таблицу шаблонов кода будет добавлена новая строка. Она содержит только введенную аббревиатуру. Курсор будет автоматически расположен на вкладке "Расширенный текст". Код шаблона можно ввести прямо на этой вкладке.
+
+NOTE: Описание синтаксиса расширенного текста шаблона кода см. в разделе <<syntax,Синтаксис шаблона кода PHP.>>
image::images/new-abb-text.png[]
@@ -373,7 +433,7 @@ image::images/uc-php.png[]
|Развернутый текст: |
-[source,java]
+[source,php]
----
defined('_JEXEC')or die('Restricted access');${cursor}
@@ -395,7 +455,7 @@ image::images/uc-joomdef.png[]
|Развернутый текст: |
-[source,java]
+[source,php]
----
$$${CONLINK newVarName default="link"} = mysql_connect('localhost', 'mysql_user', 'mysql_password'); if (!$$${CONLINK}) { die('Could not connect: ' . mysql_error()); } echo 'Connected successfully'; mysql_close($$${CONLINK}); ${cursor}
@@ -417,7 +477,7 @@ image::images/uc-mycon.png[]
|Развернутый текст: |
-[source,java]
+[source,php]
----
public function ${functionName}Action () {${selection}${cursor} }
@@ -439,13 +499,14 @@ image::images/uc-zfact.png[]
|Развернутый текст: |
-[source,java]
+[source,php]
----
$$${ELEMENT newVarName default="element"} = new Zend_Form_Element_Submit('submit', array('label' => 'Send data to server')); $$this->addElement($$${ELEMENT}); ${cursor}
----
|===
+
image::images/uc-zelement.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/php/code-templates_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/code-templates_zh_CN.asciidoc
index a8959f8..4a25ac8 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/code-templates_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/code-templates_zh_CN.asciidoc
@@ -32,9 +32,6 @@
代码模板是 NetBeans IDE 提供的预先编写的代码片段。可以使用代码完成或使用模板缩写并按 Tab 键，将代码片段粘贴到您的代码中。也可以将您的代码包含在相应的 PHP 代码片段中。最后，您可以定义自己的代码模板。本教程介绍了如何使用代码模板，并建议了定义您自己的代码模板的用例。
-image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 NetBeans IDE 7.2、7.3、7.4 和 8.0"]
-
-
*要学完本教程，您需要具备以下软件和资源。*
|===
@@ -56,7 +53,7 @@ image::images/code-template-options.png[]
在该图中，选择了新类 ( ``cls)`` 代码模板，您可以在 "Expanded Text"（展开的文本）标签中看到该模板展开后的内容。在下一节中，将使用 Tab 功能在代码中展开该模板。
-*注：*<<syntax,PHP 代码模板语法>>部分讲述了新类 ( ``cls`` ) 代码模板的语法。
+NOTE: <<syntax,PHP 代码模板语法>>部分讲述了新类 ( ``cls`` ) 代码模板的语法。
== 使用 PHP 代码模板
@@ -85,15 +82,21 @@ image::images/expand-template-on.png[]
1. 创建一个空 PHP 文件。
2. 在该文件的 PHP 块中，键入 ``cls`` ，然后按 Tab 键。将展开 ``cls`` 代码模板。
-*注：*应正确拼写缩写！如果拼错缩写，将无法展开缩写。
+NOTE: 应正确拼写缩写！如果拼错缩写，将无法展开缩写。
image::images/expanding-template-with-abb.png[]
-3. 将自动选择占位符类名 ( ``*class_name*`` )。按 Tab 键可在占位符之间移动。您可以立即键入所需的类名，该名称将覆盖占位符。在完成后，按 Enter 键，IDE 将选择第一个函数的名称，此处为构造函数。
-*注：*<<placeholder,占位符名称>>部分详细讲述了占位符名称。
+
+[start=3]
+. 将自动选择占位符类名 ( ``*class_name*`` )。按 Tab 键可在占位符之间移动。您可以立即键入所需的类名，该名称将覆盖占位符。在完成后，按 Enter 键，IDE 将选择第一个函数的名称，此处为构造函数。
+
+NOTE: <<placeholder,占位符名称>>部分详细讲述了占位符名称。
image::images/select-constructor-name.png[]
-4. 编辑函数名称或接受默认值。再次按 Enter 键，光标将移到函数主体内部。在实际情况下，您现在将开始对函数和类的其余部分进行编码。
+
+
+[start=4]
+. 编辑函数名称或接受默认值。再次按 Enter 键，光标将移到函数主体内部。在实际情况下，您现在将开始对函数和类的其余部分进行编码。
最终的光标位置是由 ``${cursor}`` 参数决定的。<<reserved-name,保留的名称>>部分中介绍了该参数。
@@ -107,11 +110,21 @@ image::images/select-constructor-name.png[]
1. 在 PHP 文件的 PHP 块中，键入 ``cla`` 。
2. 等待 "code completion"（代码完成）对话框打开。
3. 找到新类模板，将列出该模板的缩写 ( ``cls`` )。PHPDoc 框架显示了展开的模板。
+
image::images/insert-template-with-cc.png[]
-4. 选择新的类模板并按 Enter 键。IDE 将在代码中插入该模板。
-5. 将自动选择占位符类名 ( ``*class_name*`` )。按 Tab 键可在占位符之间移动。您可以立即键入所需的类名，该名称将覆盖占位符。在完成后，按 Enter 键，IDE 将选择第一个函数的名称，此处为构造函数。
+
+
+[start=4]
+. 选择新的类模板并按 Enter 键。IDE 将在代码中插入该模板。
+
+[start=5]
+. 将自动选择占位符类名 ( ``*class_name*`` )。按 Tab 键可在占位符之间移动。您可以立即键入所需的类名，该名称将覆盖占位符。在完成后，按 Enter 键，IDE 将选择第一个函数的名称，此处为构造函数。
+
image::images/select-constructor-name.png[]
-6. 编辑函数名称或接受默认值。再次按 Enter 键，光标将移到函数主体内部。在实际情况下，您现在将开始对函数和类的其余部分进行编码。
+
+
+[start=6]
+. 编辑函数名称或接受默认值。再次按 Enter 键，光标将移到函数主体内部。在实际情况下，您现在将开始对函数和类的其余部分进行编码。
=== 将代码包含在模板中
@@ -129,7 +142,7 @@ image::images/select-constructor-name.png[]
此外，您也可以<<create,创建新模板>>，如果该模板包括 `allowSurround` <<complex,参数提示>>，则可以包含代码。（感谢link:http://www.mybelovedphp.com/2012/05/14/tips-for-using-the-netbeans-editor-for-kohana-and-kostache-mustache-templates-using-surround-with/[+“我喜爱的 PHP”博客+]。）
-要将代码包含在模板中，请选择代码，然后打开 "Surround with..."（包含方式...）对话框。要打开 "Surround with..."（包含方式...）对话框，请按 Alt-Enter 组合键或者单击 "Hint"（提示）image::images/hint-icon.png[] 图标。
+要将代码包含在模板中，请选择代码，然后打开 "Surround with..."（包含方式...）对话框。要打开 "Surround with..."（包含方式...）对话框，请按 Alt-Enter 组合键或者单击 "Hint"（提示）image:images/hint-icon.png[] 图标。
*将代码包含在 if(true) 模板中：*
@@ -140,24 +153,41 @@ image::images/select-constructor-name.png[]
<?php$a = false;$b = 10;?>
----
-2. 选择行 ``$b = 10;``
+
+[start=2]
+. 选择行 ``$b = 10;``
+
image::images/selected-variable.png[]
-3. 单击 "Hint"（提示）image::images/hint-icon.png[] 图标或按 Alt-Enter 组合键。此时将打开 "Surround with..."（包含方式...）对话框。
+
+
+[start=3]
+. 单击 "Hint"（提示）image::images/hint-icon.png[] 图标或按 Alt-Enter 组合键。此时将打开 "Surround with..."（包含方式...）对话框。
+
image::images/surround-hint.png[]
-4. 单击 ``Surround with if{*true*){...`` （包含在 if{true){... 中）
+
+
+[start=4]
+. 单击 ``Surround with if{*true*){...`` （包含在 if{true){... 中）
+
image::images/surround-if-true.png[]
-5. IDE 将 ``$b = 10;`` 行包含在 ``if(*true*){...`` 模板中。
+
+
+[start=5]
+. IDE 将 ``$b = 10;`` 行包含在 ``if(*true*){...`` 模板中。
+
image::images/inserted-if-true.png[]
IDE 自动插入前面最近的适合变量作为 ``if`` 语句的条件。此处，该变量是 ``$a`` ，这是因为 ``$a`` 是布尔型变量，并且 ``if(*true*){}`` 语句将布尔型变量作为其条件。再者，如果 IDE 插入到条件中的变量不是正确的变量，则会自动选择该条件以进行编辑。这意味着，您可以在插入模板后立即开始键入正确的变量。在这种情况下，代码完成可以帮助您选择正确的变量。
-*注：*<<complex,提示定义的参数>>部分详细介绍了 ``if(*true*){}`` 模板。
+NOTE: <<complex,提示定义的参数>>部分详细介绍了 ``if(*true*){}`` 模板。
image::images/change-condition.png[]
按 Enter 键以退出语句的条件。光标将移到相应的位置，此处为 ``$b = 10;`` 行的末尾。您可以编辑条件并按 Enter 键，或者接受自动插入的条件并按 Enter 键。对于这两种情况，光标将退出条件并移到相应的位置。
-image::images/cursor-after-not-editing.png[]image::images/cursor-after-editing.png[]
+image::images/cursor-after-not-editing.png[]
+
+image::images/cursor-after-editing.png[]
下一节包含在展开的模板中编辑参数的详细信息。
@@ -169,15 +199,25 @@ image::images/cursor-after-not-editing.png[]image::images/cursor-after-editing.p
*同时编辑参数的多个实例：*
1. 在一个空 PHP 块中，键入 ``for`` ，然后按 Ctrl-空格键以打开代码完成。选择迭代模板（缩写为 ``iter`` ），然后按 Enter 键。将在代码中插入一个新迭代。
+
image::images/iter-cc.png[]
-2. 迭代将以下两个变量作为参数： ``$index`` 和 ``$array`` 。将自动选择 ``$index`` 以进行编辑。（按 Tab 键可在参数之间移动。）
+
+
+[start=2]
+. 迭代将以下两个变量作为参数： ``$index`` 和 ``$array`` 。将自动选择 ``$index`` 以进行编辑。（按 Tab 键可在参数之间移动。）
+
image::images/iteration1.png[]
键入 ``i`` 。 ``$index`` 的所有三个实例将变为 ``$i`` 。
image::images/iteration2.png[]
-3. 按 Enter 或 Tab 键。将选择 ``$array`` 参数。
-4. 按 Enter 键。光标将进入迭代的方法主体。
+
+
+[start=3]
+. 按 Enter 或 Tab 键。将选择 ``$array`` 参数。
+
+[start=4]
+. 按 Enter 键。光标将进入迭代的方法主体。
通过使用 NetBeans 中的变量名称重构功能，您只需编辑变量名称的一个实例即可更改它的所有实例。由此看出，在应用于模板参数时，该功能是多么有用！
@@ -192,16 +232,25 @@ NetBeans IDE PHP 编辑器也可以帮助确定变量的正确方法。
<?php$arr = array(new ArrayIterator($array()), new ArrayObject($array()));?>
----
-2. 在声明 ``$arr`` 数组的行后面，键入 ``fore`` ，然后使用代码完成插入 ``foreach`` 模板（缩写为 ``fore`` ）。
+
+[start=2]
+. 在声明 ``$arr`` 数组的行后面，键入 ``fore`` ，然后使用代码完成插入 ``foreach`` 模板（缩写为 ``fore`` ）。
+
image::images/cc-foreach.png[]
-3. 将光标放在 ``foreach`` 函数主体中（可以按两次 Enter 键以将光标移到此处）并键入 ``$value`` ，或者仅键入 ``$`` 并从代码完成中选择 ``$value`` 。
+
+
+[start=3]
+. 将光标放在 ``foreach`` 函数主体中（可以按两次 Enter 键以将光标移到此处）并键入 ``$value`` ，或者仅键入 ``$`` 并从代码完成中选择 ``$value`` 。
[source,php]
----
<?php$arr = array(new ArrayIterator($array()), new ArrayObject($array()));foreach ($arr as $value) {$value}?>
----
-4. 在 ``$value`` 后面，键入 ``->`` 。代码完成为您提供了 ``$value`` 变量的正确方法，该变量是从 ``$arr`` 数组派生的。
+
+[start=4]
+. 在 ``$value`` 后面，键入 ``->`` 。代码完成为您提供了 ``$value`` 变量的正确方法，该变量是从 ``$arr`` 数组派生的。
+
image::images/value-method-cc.png[]
@@ -220,7 +269,7 @@ PHP 代码模板可以包含 PHP 代码和模板参数。PHP 模板可以仅包
以下几节讲述了每种形式的代码模板参数。
-*注：* ``$$${VARIABLE...} `` 有时，您会在 PHP 代码模板中看到语法似乎为三个美元符号，后跟花括号 ``$$${...}`` 。在这种情况下，代码模板包含变量及其名称。此处的语法是转义的美元符号，记为两个美元符号 ``$$`` ，后跟变量名称参数 ``${VARIABLE...}`` 。例如， ``catch ${Exception} $$${exc}`` 代码模板展开为 [examplecode]# ``catch Exception $exc`` #。
+NOTE: ``$$${VARIABLE...} `` 有时，您会在 PHP 代码模板中看到语法似乎为三个美元符号，后跟花括号 ``$$${...}`` 。在这种情况下，代码模板包含变量及其名称。此处的语法是转义的美元符号，记为两个美元符号 ``$$`` ，后跟变量名称参数 ``${VARIABLE...}`` 。例如， ``catch ${Exception} $$${exc}`` 代码模板展开为 [examplecode]# ``catch Exception $exc`` #。
=== 占位符名称
@@ -244,7 +293,7 @@ IDE 保留两个参数名称以作为操作指令。
例如，请再次考虑本教程的<<define,定义的 PHP 模板>>和<<expand-with-abb,使用缩写 + Tab 键展开代码模板>>部分中介绍的新类模板 ``(cls)`` 。它包含 ``${ClassName}`` 和 ``$__construct`` 这两个占位符名称参数。在函数体中，它具有参数 ``${cursor}`` 和 ``${selection}`` 。
-[source,java]
+[source,php]
----
class ${ClassName} {function ${__construct} {${selection}${cursor}}}
@@ -261,7 +310,7 @@ image::images/cursor-position-changes.png[]
参数可以包含一个全部大写的任意描述性名称以及一个或多个提示。
-[source,java]
+[source,php]
----
${PARAMETER_NAME hint1[=value] [hint2...hint n]}
@@ -271,7 +320,7 @@ ${PARAMETER_NAME hint1[=value] [hint2...hint n]}
-[source,java]
+[source,php]
----
$$${CONLINK newVarName default="link"} = mysql_connect('localhost', 'mysql_user', 'mysql_password'); if (!$$${CONLINK}) { die('Could not connect: ' . mysql_error()); } echo 'Connected successfully'; mysql_close($$${CONLINK}); ${cursor}
@@ -280,7 +329,7 @@ $$${CONLINK newVarName default="link"} = mysql_connect('localhost', 'mysql_us
在 IDE 展代码模板时，提示可帮助 IDE 计算模板参数的值。例如，请查看 ``if(*true*)`` 模板，本教程的<<surround-code,将代码包含在模板中>>部分中使用了该模板。该模板的展开文本是
-[source,java]
+[source,php]
----
if (${CONDITION variableFromPreviousAssignment instanceof="boolean" default="true"}) {${selection}${cursor}}
@@ -326,12 +375,20 @@ image::images/inserted-if-true.png[]
*创建代码模板：*
1. 打开 "Tools"（工具）> "Options"（选项）（在 Mac 上为 "NetBeans" > "Preferences"（首选项）），选择 "Editor"（编辑器）功能，然后选择 "Code Templates"（代码模板）标签。
+
image::images/code-template-options.png[]
-2. 单击 "New"（新建）以打开 "New Code Template"（新建代码模板）对话框。键入所需的模板缩写，然后单击 "OK"（确定）。
+
+
+[start=2]
+. 单击 "New"（新建）以打开 "New Code Template"（新建代码模板）对话框。键入所需的模板缩写，然后单击 "OK"（确定）。
+
image::images/new-abb.png[]
-3. 将在代码模板表中添加一个新行。该行仅包含您提供的缩写。光标位于 "Expanded Text"（展开的文本）标签中，IDE 自动将光标放在该位置。您可以立即开始键入模板的代码。
-*注：*要了解代码模板的展开文本的语法，请参见 <<syntax,PHP 代码模板语法>>部分。
+
+[start=3]
+. 将在代码模板表中添加一个新行。该行仅包含您提供的缩写。光标位于 "Expanded Text"（展开的文本）标签中，IDE 自动将光标放在该位置。您可以立即开始键入模板的代码。
+
+NOTE: 要了解代码模板的展开文本的语法，请参见 <<syntax,PHP 代码模板语法>>部分。
image::images/new-abb-text.png[]
@@ -373,7 +430,7 @@ image::images/uc-php.png[]
|展开的文本： |
-[source,java]
+[source,php]
----
defined('_JEXEC')or die('Restricted access');${cursor}
@@ -395,7 +452,7 @@ PHP 开发者经常需要创建到 MySQL 数据库的连接。该代码模板将
|展开的文本： |
-[source,java]
+[source,php]
----
$$${CONLINK newVarName default="link"} = mysql_connect('localhost', 'mysql_user', 'mysql_password'); if (!$$${CONLINK}) { die('Could not connect: ' . mysql_error()); } echo 'Connected successfully'; mysql_close($$${CONLINK}); ${cursor}
@@ -417,7 +474,7 @@ image::images/uc-mycon.png[]
|展开的文本： |
-[source,java]
+[source,php]
----
public function ${functionName}Action () {${selection}${cursor} }
@@ -439,13 +496,14 @@ image::images/uc-zfact.png[]
|展开的文本： |
-[source,java]
+[source,php]
----
$$${ELEMENT newVarName default="element"} = new Zend_Form_Element_Submit('submit', array('label' => 'Send data to server')); $$this->addElement($$${ELEMENT}); ${cursor}
----
|===
+
image::images/uc-zelement.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os.asciidoc
index ca5145b..a29c773 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os.asciidoc
@@ -52,15 +52,15 @@ NOTE: The MAMP package includes the Apache web server, PHP engine, and MySQL dat
image::images/mamp-install.png[title="MAMP installer panel showing MAMP and MAMP-Pro options"]
[start=3]
-3. Navigate to `/Applications/MAMP` and double-click `MAMP.app`. The MAMP Control Panel opens.
+. Navigate to `/Applications/MAMP` and double-click `MAMP.app`. The MAMP Control Panel opens.
You can also install the MAMP Control dashboard widget as described in `MAMP/README.rtf`, which enables you to start and stop servers.
image::images/mamp-control-panel.png[]
[start=4]
-4. Click Preferences to open the Preferences panel, then select the Ports tab.
-5. Click Set to Default Apache and MySQL ports. Apache port is reset to 80 and MySQL to 3306.
+. Click Preferences to open the Preferences panel, then select the Ports tab.
+. Click Set to Default Apache and MySQL ports. Apache port is reset to 80 and MySQL to 3306.
image::images/mamp-control-panel-preferences-ports.png[title="MAMP control panel with Ports tab, after ports have been changed to default values"]
@@ -81,7 +81,7 @@ The IDE interfaces with databases from the Services window (⌘-5). You can regi
image::images/mysql-basic-properties.png[title="MySQL Basic Properties dialog containing MAMP's default connectivity settings"]
[start=3]
-3. Select the Admin Properties tab to display settings that enable you to start and stop the database server from the IDE. MAMP maintains shell scripts in its `bin` folder. You can find scripts for starting and stopping servers there. For the path to the Admin tool, you have a choice; you can link to `MAMP.app` so that you can use the IDE to open MAMP's control panel. To do so, enter `/Applications/MAMP/MAMP.app`. However, an alternative option would be to use the link:http://dev.mysql.c [...]
+. Select the Admin Properties tab to display settings that enable you to start and stop the database server from the IDE. MAMP maintains shell scripts in its `bin` folder. You can find scripts for starting and stopping servers there. For the path to the Admin tool, you have a choice; you can link to `MAMP.app` so that you can use the IDE to open MAMP's control panel. To do so, enter `/Applications/MAMP/MAMP.app`. However, an alternative option would be to use the link:http://dev.mysql.co [...]
* *Path/URL to admin tool: *`/Applications/MySQL Tools/MySQLWorkbench.app` _(default installation for MySQL Workbench)_
* *Path to start command: *`/Applications/MAMP/bin/startMysql.sh`
@@ -90,12 +90,12 @@ image::images/mysql-basic-properties.png[title="MySQL Basic Properties dialog co
image::images/mysql-admin-props.png[title="MySQL Admin Properties dialog containing sample administration settings"]
[start=4]
-4. If you choose to use the MySQL Workbench as your MySQL admin tool, you need to specify the socket for the connection to MAMP's database. Start MySQL Workbench and from the main page, click New Server Instance in the Server Administration column.
+. If you choose to use the MySQL Workbench as your MySQL admin tool, you need to specify the socket for the connection to MAMP's database. Start MySQL Workbench and from the main page, click New Server Instance in the Server Administration column.
image::images/mysql-workbench-home.png[]
[start=5]
-5. The Create New Server Instance Profile dialog opens. Select the Local Socket/Pipe connection method and add the path to the socket file in the Parameters tab. The default location of the socket is: `/Applications/MAMP/tmp/mysql/mysql.sock`.
+. The Create New Server Instance Profile dialog opens. Select the Local Socket/Pipe connection method and add the path to the socket file in the Parameters tab. The default location of the socket is: `/Applications/MAMP/tmp/mysql/mysql.sock`.
image::images/socket-path.png[]
@@ -123,7 +123,7 @@ To enable Xdebug with MAMP:
1. Open the `php.ini` file in an editor. This file is located in: `/Applications/MAMP/conf/php5/php.ini`.
2. Locate the ``[Zend]`` section and comment out every line.
-[source,bash]
+[source,ini]
----
;[Zend]
@@ -135,9 +135,9 @@ To enable Xdebug with MAMP:
----
[start=3]
-3. Locate the ``[xdebug]`` section and activate Xdebug (replace `xxxxxxxx` with the actual number). Add this section to the end of ``php.ini`` if it is not there.
+. Locate the ``[xdebug]`` section and activate Xdebug (replace `xxxxxxxx` with the actual number). Add this section to the end of ``php.ini`` if it is not there.
-[source,bash]
+[source,ini]
----
[xdebug]
@@ -156,18 +156,19 @@ zend_extension="/Applications/MAMP/bin/php5/lib/php/extensions/no-debug-non-zts-
For an explanation of these properties, see Related Settings in the link:http://www.Xdebug.org/docs/remote[+Xdebug Remote Debugging+] documentation.
[start=4]
-4. Note that the remote port specified for Xdebug in the previous step is: 9000. This is the default debugger port used in NetBeans. To verify this, choose NetBeans > Preferences from the main menu, then select PHP in the Options window.
+. Note that the remote port specified for Xdebug in the previous step is: 9000. This is the default debugger port used in NetBeans. To verify this, choose NetBeans > Preferences from the main menu, then select PHP in the Options window.
image::images/php-options68.png[title="The debugging port can be set in the PHP Options window"]
If needed, you can change the debugger port here.
[start=5]
-5. Open the MAMP control panel and select the PHP tab. Deselect Zend Optimizer.
+. Open the MAMP control panel and select the PHP tab. Deselect Zend Optimizer.
image::images/mamp-control-panel-preferences-php.png[title="MAMP Control Panel with PHP tab, after Zend Optimizer has been unselected"]
-6. Start (or restart) the MAMP Apache server.
+[start=6]
+. Start (or restart) the MAMP Apache server.
== Debugging PHP Projects
diff --git a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os_ja.asciidoc
index 1822211..786fdf3 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os_ja.asciidoc
@@ -33,10 +33,6 @@
link:http://www.Xdebug.org/[+Xdebug+]はPHPの拡張機能で、PHPスクリプトをデバッグするための有用な情報を提供します。NetBeansデバッガはXdebug拡張上で機能し、開発環境に効率的なデバッグ・ツールを提供します。
-
-image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、NetBeans IDE 7.2、7.3、7.4および8.0に適用されます"]
-
-
*このチュートリアルを完了するには、次のソフトウェアとリソースが必要です。*
|===
@@ -51,20 +47,31 @@ image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、N
|link:http://www.Xdebug.org/download.php[+Xdebug+](オプション) |2.x
|===
-*注意: *MAMPパッケージにはApache Webサーバー、PHPエンジン、MySQLデータベースが含まれます。Mac OS X 10.5以降には、PHPサポート付きのMySQLデータベースとApacheサーバーが含まれます。IDEで組込みデータベースおよびサーバーを構成することは可能ですが、MAMPのオールインワン・バンドルで簡便かつ容易に構成可能なソリューションが提供されます。
+NOTE: MAMPパッケージにはApache Webサーバー、PHPエンジン、MySQLデータベースが含まれます。Mac OS X 10.5以降には、PHPサポート付きのMySQLデータベースとApacheサーバーが含まれます。IDEで組込みデータベースおよびサーバーを構成することは可能ですが、MAMPのオールインワン・バンドルで簡便かつ容易に構成可能なソリューションが提供されます。
== MAMPのインストールと構成
1. link:http://www.mamp.info/en/download.html[+MAMP+]の最新バージョンをダウンロードします。
2. ダウンロードしたファイルを解凍し、`.dmg`ファイルを実行します。インストーラが表示されたら、MAMPを`/Applications`フォルダにドラッグします。
+
image::images/mamp-install.png[title="MAMPおよびMAMP-Proオプションを示すMAMPインストーラ・パネル"]
-3. `/Applications/MAMP`に移動して`MAMP.app`をダブルクリックします。MAMPコントロール・パネルが開きます。
+
+
+[start=3]
+. `/Applications/MAMP`に移動して`MAMP.app`をダブルクリックします。MAMPコントロール・パネルが開きます。
`MAMP/README.rtf`に説明されているとおりにMAMPコントロール・ダッシュボード・ウィジェットをインストールし、サーバーを起動および停止することもできます。
+
image::images/mamp-control-panel.png[]
-4. 「プリファレンス」をクリックして「プリファレンス」パネルを開き、「ポート」タブを選択します。
-5. 「デフォルトのApacheおよびMySQLポートに設定」をクリックします。Apacheポートは80に、MySQLは3306にリセットされます。
+
+
+[start=4]
+. 「プリファレンス」をクリックして「プリファレンス」パネルを開き、「ポート」タブを選択します。
+
+[start=5]
+. 「デフォルトのApacheおよびMySQLポートに設定」をクリックします。Apacheポートは80に、MySQLは3306にリセットされます。
+
image::images/mamp-control-panel-preferences-ports.png[title="ポートをデフォルト値に変更した後のMAMPコントロール・パネルと「ポート」タブ"]
@@ -81,16 +88,29 @@ IDEは「サービス」ウィンドウ(⌘-5)でデータベースと接続し
* *サーバー・ポート番号: *`3306`
* *管理ユーザー名: *`root`
* *管理パスワード: *`root`
+
image::images/mysql-basic-properties.png[title="MAMPのデフォルト接続設定を含むMySQL基本プロパティ・ダイアログ"]
-3. 「管理プロパティ」タブを選択して、IDEからデータベース・サーバーを起動および停止するための設定を表示します。MAMPでは、`bin`フォルダにシェル・スクリプトが保持されます。ここで、サーバーを起動および停止するためのスクリプトを見つけることができます。管理ツールのパスに`MAMP.app`へのリンクを設定し、IDEを使用してMAMPのコントロール・パネルを開くことができます。これを行うには、`/Applications/MAMP/MAMP.app`を入力します。かわりに、管理操作(MySQLサーバーの構成およびモニタリング、ユーザーおよび接続の管理、バックアップの実行など)を実行するための直感的なGUIインタフェースが備えられたlink:http://dev.mysql.com/downloads/workbench/[+MySQL Workbench+]を使用することもできます。 MySQL Workbenchを使用するには、まずダウンロード�
�よびインストールし、次の設定をダイアログに入力します。
+
+
+[start=3]
+. 「管理プロパティ」タブを選択して、IDEからデータベース・サーバーを起動および停止するための設定を表示します。MAMPでは、`bin`フォルダにシェル・スクリプトが保持されます。ここで、サーバーを起動および停止するためのスクリプトを見つけることができます。管理ツールのパスに`MAMP.app`へのリンクを設定し、IDEを使用してMAMPのコントロール・パネルを開くことができます。これを行うには、`/Applications/MAMP/MAMP.app`を入力します。かわりに、管理操作(MySQLサーバーの構成およびモニタリング、ユーザーおよび接続の管理、バックアップの実行など)を実行するための直感的なGUIインタフェースが備えられたlink:http://dev.mysql.com/downloads/workbench/[+MySQL Workbench+]を使用することもできます。 MySQL Workbenchを使用するには、まずダウンロードお
よびインストールし、次の設定をダイアログに入力します。
* *管理ツールのパス/URL: *`/Applications/MySQL Tools/MySQLWorkbench.app` _(MySQL Workbenchのデフォルト・インストール)_
* *startコマンドのパス: *`/Applications/MAMP/bin/startMysql.sh`
* *stopコマンドのパス: *`/Applications/MAMP/bin/stopMysql.sh`
+
image::images/mysql-admin-props.png[title="サンプルの管理設定を含むMySQL管理プロパティ・ダイアログ"]
-4. MySQL WorkbenchをMySQL管理ツールとして使用する場合は、MAMPのデータベースへの接続用のソケットを指定する必要があります。MySQL Workbenchを起動し、メイン・ページでサーバー管理列の新規サーバー・インスタンスをクリックします。
+
+
+[start=4]
+. MySQL WorkbenchをMySQL管理ツールとして使用する場合は、MAMPのデータベースへの接続用のソケットを指定する必要があります。MySQL Workbenchを起動し、メイン・ページでサーバー管理列の新規サーバー・インスタンスをクリックします。
+
image::images/mysql-workbench-home.png[]
-5. 「新規サーバー・インスタンス・プロファイルの作成」ダイアログが開きます。ローカル・ソケット/パイプ接続方法を選択し、ソケット・ファイルのパスを「パラメータ」タブに追加します。ソケットのデフォルトの場所は`/Applications/MAMP/tmp/mysql/mysql.sock`です。
+
+
+[start=5]
+. 「新規サーバー・インスタンス・プロファイルの作成」ダイアログが開きます。ローカル・ソケット/パイプ接続方法を選択し、ソケット・ファイルのパスを「パラメータ」タブに追加します。ソケットのデフォルトの場所は`/Applications/MAMP/tmp/mysql/mysql.sock`です。
+
image::images/socket-path.png[]
@@ -99,7 +119,7 @@ image::images/socket-path.png[]
MAMPのリソースを使用してIDEでPHPプロジェクトを作成する場合、IDEでソースをApacheの`htdocs`フォルダにコピーするよう指定する必要があります。このようにして、変更後にファイルを保存する際に、ソースが自動的にデプロイ後バージョンで更新されます。
-たとえば、新しいPHPプロジェクトの作成時に、新規プロジェクト・ウィザードを使用します(IDEのツールバーで「新規プロジェクト」アイコンをクリック(image::images/new-project-icon.png[]))。ウィザードの3番目の手順「実行構成」で、「ファイルをソース・フォルダから別の場所にコピー」オプションを選択し、`htdocs`フォルダのパスを入力します。
+たとえば、新しいPHPプロジェクトの作成時に、新規プロジェクト・ウィザードを使用します(IDEのツールバーで「新規プロジェクト」アイコンをクリック(image:images/new-project-icon.png[]))。ウィザードの3番目の手順「実行構成」で、「ファイルをソース・フォルダから別の場所にコピー」オプションを選択し、`htdocs`フォルダのパスを入力します。
[.feature]
--
@@ -118,9 +138,11 @@ MAMPには、プリコンパイルされた ``xdebug.so`` ファイルが含ま
1. エディタで`php.ini`ファイルを開きます。このファイルは次の場所にあります。
`/Applications/MAMP/conf/php5/php.ini`
-2. ``[Zend]`` セクションを見つけて、各行をコメントにします。
-[source,java]
+[start=2]
+. ``[Zend]`` セクションを見つけて、各行をコメントにします。
+
+[source,ini]
----
;[Zend]
@@ -130,9 +152,11 @@ MAMPには、プリコンパイルされた ``xdebug.so`` ファイルが含ま
;zend_extension=/Applications/MAMP/bin/php5/zend/lib/ZendExtensionManager.so
----
-3. ``[xdebug]`` セクションを見つけて、Xdebugをアクティブ化します(`xxxxxxxx`を実際の数値に置き換えます)。このセクションが ``php.ini`` の末尾にない場合は追加します。
-[source,java]
+[start=3]
+. ``[xdebug]`` セクションを見つけて、Xdebugをアクティブ化します(`xxxxxxxx`を実際の数値に置き換えます)。このセクションが ``php.ini`` の末尾にない場合は追加します。
+
+[source,ini]
----
[xdebug]
@@ -148,17 +172,27 @@ xdebug.remote_autostart=1
zend_extension="/Applications/MAMP/bin/php5/lib/php/extensions/no-debug-non-zts-xxxxxxxx/xdebug.so"
----
これらのプロパティの説明については、link:http://www.Xdebug.org/docs/remote[+Xdebugリモート・デバッグ+]・ドキュメントの関連する設定を参照してください。
-4. 前の手順でXdebugに指定されたリモート・ポートは9000です。これは、NetBeansで使用されるデフォルトのデバッガ・ポートです。これを確認するには、メイン・メニューから「NetBeans」>「プリファレンス」を選択し、「オプション」ウィンドウで「PHP」を選択します。
- image::images/php-options68.png[title="デバッガ・ポートは、「PHPオプション」ウィンドウで設定できます。"]
+
+[start=4]
+. 前の手順でXdebugに指定されたリモート・ポートは9000です。これは、NetBeansで使用されるデフォルトのデバッガ・ポートです。これを確認するには、メイン・メニューから「NetBeans」>「プリファレンス」を選択し、「オプション」ウィンドウで「PHP」を選択します。
+
+image::images/php-options68.png[title="デバッガ・ポートは、「PHPオプション」ウィンドウで設定できます。"]
+
必要に応じて、ここでデバッガ・ポートを変更できます。
-5. MAMPコントロール・パネルを開き、「PHP」タブを選択します。Zendオプティマイザを選択解除します。
+
+[start=5]
+. MAMPコントロール・パネルを開き、「PHP」タブを選択します。Zendオプティマイザを選択解除します。
+
image::images/mamp-control-panel-preferences-php.png[title="Zendオプティマイザを選択解除した後のMAMPコントロール・パネルと「PHP」タブ"]
-6. MAMP Apacheサーバーを起動(または再起動)します。
+
+
+[start=6]
+. MAMP Apacheサーバーを起動(または再起動)します。
== PHPプロジェクトのデバッグ
-IDEでPHPプロジェクトをデバッグするには、「プロジェクト」ウィンドウでプロジェクトを右クリックして「デバッグ」を選択します。プロジェクトが「プロジェクト」ウィンドウで強調表示されている場合は、メイン・ツールバーで「プロジェクトのデバッグ」アイコン(image::images/debug-icon.png[])をクリックできます。
+IDEでPHPプロジェクトをデバッグするには、「プロジェクト」ウィンドウでプロジェクトを右クリックして「デバッグ」を選択します。プロジェクトが「プロジェクト」ウィンドウで強調表示されている場合は、メイン・ツールバーで「プロジェクトのデバッグ」アイコン(image:images/debug-icon.png[])をクリックできます。
<<phpOptions,「PHPオプション」ウィンドウ>>でこのオプションを有効にすることで、コードの最初の行でデバッガを一時停止するよう設定できます。
diff --git a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os_pt_BR.asciidoc
index fa3767a..f12b5a8 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os_pt_BR.asciidoc
@@ -34,9 +34,6 @@ Este tutorial mostra como configurar o PHP no pacote link:http://www.mamp.info/e
link:http://www.Xdebug.org/[+Xdebug+] é uma extensão para PHP que ajuda a fornecer informações valiosas para depuração de scripts PHP. O depurador do NetBeans funciona sobre a extensão Xdebug, fornecendo uma ferramenta de depuração eficiente no ambiente de desenvolvimento.
-image::images/netbeans-stamp-80-74-73.png[title="O conteúdo desta página se aplica ao NetBeans IDE 7.2, 7.3, 7.4 e 8.0"]
-
-
*Para concluir este tutorial, você precisa dos seguintes recursos e softwares.*
|===
@@ -51,20 +48,31 @@ image::images/netbeans-stamp-80-74-73.png[title="O conteúdo desta página se ap
|link:http://www.Xdebug.org/download.php[+Xdebug+] (opcional) |2.x
|===
-*Observação: *o pacote MAMP inclui o servidor web Apache, o mecanismo PHP e o banco de dados MySQL. O Mac OS X 10.5 e mais recente incluem o banco de dados MySQL e o servidor Apache com suporte PHP. Embora certamente seja possível configurar o banco de dados e o servidor incorporado com o IDE, o pacote tudo em um do MAMP oferece uma solução prática e facilmente configurável.
+NOTE: o pacote MAMP inclui o servidor web Apache, o mecanismo PHP e o banco de dados MySQL. O Mac OS X 10.5 e mais recente incluem o banco de dados MySQL e o servidor Apache com suporte PHP. Embora certamente seja possível configurar o banco de dados e o servidor incorporado com o IDE, o pacote tudo em um do MAMP oferece uma solução prática e facilmente configurável.
== Instalando e Configurando o MAMP
1. Faça o download da versão mais recente do link:http://www.mamp.info/en/download.html[+MAMP+].
2. Extraia o arquivo de download e execute o arquivo `.dmg`. Quando o instalador for exibido, arraste o MAMP para a pasta `/Applications`.
+
image::images/mamp-install.png[title="Painel do instalador do MAMP mostrando as opções MAMP e MAMP-Pro"]
-3. Navegue até `/Applications/MAMP` e clique duas vezes em `MAMP.app`. É aberto o Painel de Controle do MAMP.
+
+
+[start=3]
+. Navegue até `/Applications/MAMP` e clique duas vezes em `MAMP.app`. É aberto o Painel de Controle do MAMP.
Você também pode instalar o widget do painel de controle do MAMP conforme descrito em `MAMP/README.rtf`, que permite iniciar e interromper servidores.
+
image::images/mamp-control-panel.png[]
-4. Clique em Preferências para abrir o painel Preferências; em seguida, selecione a guia Portas.
-5. Clique em Definir como Padrão as portas do Apache e MySQL. A porta do Apache é redefinida como 80 e a do MySQL como 3306.
+
+
+[start=4]
+. Clique em Preferências para abrir o painel Preferências; em seguida, selecione a guia Portas.
+
+[start=5]
+. Clique em Definir como Padrão as portas do Apache e MySQL. A porta do Apache é redefinida como 80 e a do MySQL como 3306.
+
image::images/mamp-control-panel-preferences-ports.png[title="Painel de controle do MAMP com a guia Portas, depois que as portas foram alteradas para os valores padrão"]
@@ -81,16 +89,29 @@ As interfaces do IDE com bancos de dados na janela Serviços (⌘-5). Você pode
* *Número da Porta do Servidor: *`3306`
* *Nome do Usuário Administrador: *`root`
* *Senha de Administrador: *`root`
+
image::images/mysql-basic-properties.png[title="Caixa de diálogo Propriedades Básicas do MySQL contendo as definições de conectividade padrão do MAMP"]
-3. Selecione a guia Propriedades de Admin para exibir as definições que permitem a você iniciar e interromper o servidor de banco de dados no IDE. O MAMP mantém os scripts de shell na pasta `bin`. Nessa pasta, você encontra os scripts para iniciar e interromper os servidores. Para o caminho até a ferramenta Admin, você tem uma opção: pode estabelecer um link com `MAMP.app` de modo que possa usar o IDE para abrir o painel de controle do MAMP. Para isso, digite `/Applications/MAMP/MAMP.app [...]
+
+
+[start=3]
+. Selecione a guia Propriedades de Admin para exibir as definições que permitem a você iniciar e interromper o servidor de banco de dados no IDE. O MAMP mantém os scripts de shell na pasta `bin`. Nessa pasta, você encontra os scripts para iniciar e interromper os servidores. Para o caminho até a ferramenta Admin, você tem uma opção: pode estabelecer um link com `MAMP.app` de modo que possa usar o IDE para abrir o painel de controle do MAMP. Para isso, digite `/Applications/MAMP/MAMP.app` [...]
* *Caminho/URL para a ferramenta admin: *`/Applications/MySQL Tools/MySQLWorkbench.app` _(instalação padrão do MySQL Workbench)_
* *Caminho para o comando de início: *`/Applications/MAMP/bin/startMysql.sh`
* *Caminho para o comando de interrupção: *`/Applications/MAMP/bin/stopMysql.sh`
+
image::images/mysql-admin-props.png[title="Caixa de diálogo Propriedades de Admin do MySQL contendo definições de administração de amostra"]
-4. Se você optar por usar o MySQL Workbench como sua ferramenta admin do MySQL, especifique o soquete para conexão com o banco de dados do MAMP. Inicie o MySQL Workbench e, na página principal, clique em Nova Instância do Servidor, na coluna Administração do Servidor.
+
+
+[start=4]
+. Se você optar por usar o MySQL Workbench como sua ferramenta admin do MySQL, especifique o soquete para conexão com o banco de dados do MAMP. Inicie o MySQL Workbench e, na página principal, clique em Nova Instância do Servidor, na coluna Administração do Servidor.
+
image::images/mysql-workbench-home.png[]
-5. A caixa de diálogo Criar Perfil da Nova Instância do Servidor é aberta. Selecione o método de conexão Soquete/Pipe Local e adicione o caminho para o arquivo do soquete na guia Parâmetros. O local padrão do soquete é: `/Applications/MAMP/tmp/mysql/mysql.sock`.
+
+
+[start=5]
+. A caixa de diálogo Criar Perfil da Nova Instância do Servidor é aberta. Selecione o método de conexão Soquete/Pipe Local e adicione o caminho para o arquivo do soquete na guia Parâmetros. O local padrão do soquete é: `/Applications/MAMP/tmp/mysql/mysql.sock`.
+
image::images/socket-path.png[]
@@ -99,7 +120,7 @@ image::images/socket-path.png[]
Quando você criar um projeto PHP no IDE usando recursos do MAMP, especifique para que o IDE copie os códigos-fonte na pasta `htdocs` do Apache. Dessa forma, depois de salvar seus arquivos após fazer alterações, os códigos-fonte sejam atualizados automaticamente na versão implantada.
-Por exemplo, ao criar um novo projeto PHP, use o Assistente de Novo Projeto (clique no ícone Novo Projeto, na barra de ferramentas do IDE ( image::images/new-project-icon.png[] ). Na terceira etapa do assistente, Executar Configuração, selecione a opção Copiar arquivos da Pasta de Códigos-fonte para outro local, e digite o caminho para a pasta `htdocs`.
+Por exemplo, ao criar um novo projeto PHP, use o Assistente de Novo Projeto (clique no ícone Novo Projeto, na barra de ferramentas do IDE ( image:images/new-project-icon.png[] ). Na terceira etapa do assistente, Executar Configuração, selecione a opção Copiar arquivos da Pasta de Códigos-fonte para outro local, e digite o caminho para a pasta `htdocs`.
[.feature]
--
@@ -118,9 +139,11 @@ O MAMP contém um arquivo ``xdebug.so`` pré-compilado. Para usar esse arquivo
1. Abra o arquivo `php.ini` em um editor de texto. Esse arquivo se encontra em
`/Applications/MAMP/conf/php5/php.ini`.
-2. Localize a seção ``[Zend]`` e transforme cada linha em comentário.
-[source,java]
+[start=2]
+. Localize a seção ``[Zend]`` e transforme cada linha em comentário.
+
+[source,ini]
----
;[Zend]
@@ -130,9 +153,11 @@ O MAMP contém um arquivo ``xdebug.so`` pré-compilado. Para usar esse arquivo
;zend_extension=/Applications/MAMP/bin/php5/zend/lib/ZendExtensionManager.so
----
-3. Localize a seção ``[xdebug]`` e ative o Xdebug (substitua `xxxxxxxx` pelo número real). Adicione essa seção ao final de ``php.ini`` se não estiver lá.
-[source,java]
+[start=3]
+. Localize a seção ``[xdebug]`` e ative o Xdebug (substitua `xxxxxxxx` pelo número real). Adicione essa seção ao final de ``php.ini`` se não estiver lá.
+
+[source,ini]
----
[xdebug]
@@ -148,17 +173,27 @@ xdebug.remote_autostart=1
zend_extension="/Applications/MAMP/bin/php5/lib/php/extensions/no-debug-non-zts-xxxxxxxx/xdebug.so"
----
Para obter uma explicação dessas propriedades, consulte Related Settings na documentação link:http://www.Xdebug.org/docs/remote[+Xdebug Remote Debugging+].
-4. Observe que a porta remota especificada para o Xdebug na etapa anterior é 9000. Essa é a porta do depurador padrão usada no NetBeans. Para confirmar, escolha NetBeans > Preferências no menu principal e selecione PHP na janela Opções.
- image::images/php-options68.png[title="A porta de depuração pode ser definida na janela Opções PHP"]
+
+[start=4]
+. Observe que a porta remota especificada para o Xdebug na etapa anterior é 9000. Essa é a porta do depurador padrão usada no NetBeans. Para confirmar, escolha NetBeans > Preferências no menu principal e selecione PHP na janela Opções.
+
+image::images/php-options68.png[title="A porta de depuração pode ser definida na janela Opções PHP"]
+
Se for necessário, você poderá alterar a porta do depurador aqui.
-5. Abra o painel de controle do MAMP e selecione a guia PHP. Desmarque Zend Optimizer.
+
+[start=5]
+. Abra o painel de controle do MAMP e selecione a guia PHP. Desmarque Zend Optimizer.
+
image::images/mamp-control-panel-preferences-php.png[title="Painel de Controle do MAMP com a guia PHP, depois que o Zend Optimizer foi desmarcado"]
-6. Inicie (ou reinicie) o servidor Apache do MAMP.
+
+
+[start=6]
+. Inicie (ou reinicie) o servidor Apache do MAMP.
== Depurando Projetos PHP
-Para depurar um projeto PHP no IDE, clique com o botão direito do mouse no projeto, na janela Projetos, e escolha Depurar. Como alternativa, se o projeto estiver destacado na janela Projetos, você poderá clicar no ícone Depurar Projeto ( image::images/debug-icon.png[] ) na barra de ferramentas principal.
+Para depurar um projeto PHP no IDE, clique com o botão direito do mouse no projeto, na janela Projetos, e escolha Depurar. Como alternativa, se o projeto estiver destacado na janela Projetos, você poderá clicar no ícone Depurar Projeto ( image:images/debug-icon.png[] ) na barra de ferramentas principal.
Você pode definir o depurador para ser suspenso na primeira linha de código, ativando essa opção na <<phpOptions,janela Opções PHP>>.
diff --git a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os_ru.asciidoc
index 364aad2..b4dfd80 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os_ru.asciidoc
@@ -33,10 +33,6 @@
link:http://www.Xdebug.org/[+Xdebug+] - расширение для PHP, используемое для предоставления ценной информации для отладки сценариев PHP. Отладчик NetBeans работает поверх расширения Xdebug, что обеспечивает эффективный механизм отладки для среды разработки.
-
-image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой страницы применимо к IDE NetBeans 7.2, 7.3, 7.4 и 8.0"]
-
-
*Для работы с этим учебным курсом требуются программное обеспечение и ресурсы, перечисленные ниже.*
|===
@@ -51,20 +47,31 @@ image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой
|link:http://www.Xdebug.org/download.php[+Xdebug+] (не обязательно) |2.x
|===
-*Примечание. *В пакет MAMP входят веб-сервер Apache, модуль PHP и база данных MySQL. Mac OS X 10.5 и более поздние версии включают в себя базу данных MySQL и сервера Apache с поддержкой PHP. Разумеется, встроенную базу данных и сервер можно настроить и в IDE, но универсальный пакет MAMP представляет собой более удобное и простое решение.
+NOTE: В пакет MAMP входят веб-сервер Apache, модуль PHP и база данных MySQL. Mac OS X 10.5 и более поздние версии включают в себя базу данных MySQL и сервера Apache с поддержкой PHP. Разумеется, встроенную базу данных и сервер можно настроить и в IDE, но универсальный пакет MAMP представляет собой более удобное и простое решение.
== Установка и настройка MAMP
1. Загрузите последнюю версию link:http://www.mamp.info/en/download.html[+MAMP+].
2. Распакуйте загруженный архив и запустите файл `.dmg`. Когда отобразится экран установщика, переместите MAMP в папку `/Applications`.
+
image::images/mamp-install.png[title="На экране установщика MAMP отображаются компоненты MAMP и MAMP-Pro"]
-3. Перейдите в папку `/Applications/MAMP` и дважды щелкните файл `MAMP.app`. Открывается панель управления MAMP.
+
+
+[start=3]
+. Перейдите в папку `/Applications/MAMP` и дважды щелкните файл `MAMP.app`. Открывается панель управления MAMP.
Также можно установить виджет панели управления MAMP, следуя инструкциям в файле `MAMP/README.rtf`. С помощью этого виджета можно будет запускать и останавливать серверы.
+
image::images/mamp-control-panel.png[]
-4. Нажмите "Предпочтения". На открывшейся панели "Предпочтения" перейдите на вкладку "Порты".
-5. Выберите параметр "Значения умолчанию" для портов Apache и MySQL. Для порта Apache устанавливается значение 80, а для порта MySQL - 3306.
+
+
+[start=4]
+. Нажмите "Предпочтения". На открывшейся панели "Предпочтения" перейдите на вкладку "Порты".
+
+[start=5]
+. Выберите параметр "Значения умолчанию" для портов Apache и MySQL. Для порта Apache устанавливается значение 80, а для порта MySQL - 3306.
+
image::images/mamp-control-panel-preferences-ports.png[title="Панель управления MAMP со вкладкой "Порты", на которой установлены значения портов по умолчанию"]
@@ -81,16 +88,29 @@ IDE взаимодействует с базами данных в окне "С
* *Номер порта сервера: *`3306`
* *Имя администратора: *`root`
* *Пароль администратора: *`root`
+
image::images/mysql-basic-properties.png[title="В диалоговом окне "Основные свойства MySQL" можно настроить параметры подключений MAMP, используемые по умолчанию"]
-3. Перейдите на вкладку "Администрирование", где можно настроить параметры запуска и останова сервера баз данных в IDE. Сценарии оболочки MAMP хранятся в папке `bin`. Здесь находятся сценарии для запуска и останова серверов. Вы можете выбрать путь к средствам администрирования и связать IDE с файлом `MAMP.app`, чтобы в дальнейшем запускать панель управления MAMP из IDE. Для этого введите путь `/Applications/MAMP/MAMP.app`. В качестве альтернативы можно использовать инструмент link:http:/ [...]
+
+
+[start=3]
+. Перейдите на вкладку "Администрирование", где можно настроить параметры запуска и останова сервера баз данных в IDE. Сценарии оболочки MAMP хранятся в папке `bin`. Здесь находятся сценарии для запуска и останова серверов. Вы можете выбрать путь к средствам администрирования и связать IDE с файлом `MAMP.app`, чтобы в дальнейшем запускать панель управления MAMP из IDE. Для этого введите путь `/Applications/MAMP/MAMP.app`. В качестве альтернативы можно использовать инструмент link:http:// [...]
* *Путь/URL средства администрирования: *`/Applications/MySQL Tools/MySQLWorkbench.app` _(папка установки MySQL Workbench по умолчанию)_
* *Путь для команды запуска: *`/Applications/MAMP/bin/startMysql.sh`
* *Путь для команды останова: *`/Applications/MAMP/bin/stopMysql.sh`
+
image::images/mysql-admin-props.png[title="В диалоговом окне "Администрирование MySQL" можно настроить примерные параметры администрирования"]
-4. Если в качестве инструмента администрирования сервера MySQL планируется использовать MySQL Workbench, необходимо указать сокет для подключения к базе данных MAMP. Запустите MySQL Workbench. В разделе "Администрирование сервера" на главной странице выберите "Новый экземпляр сервера".
+
+
+[start=4]
+. Если в качестве инструмента администрирования сервера MySQL планируется использовать MySQL Workbench, необходимо указать сокет для подключения к базе данных MAMP. Запустите MySQL Workbench. В разделе "Администрирование сервера" на главной странице выберите "Новый экземпляр сервера".
+
image::images/mysql-workbench-home.png[]
-5. Отображается диалоговое окно "Создать профиль нового экземпляра сервера". Выберите метод подключения "Локальный сокет/канал" и укажите путь к файлу сокета на вкладке "Параметры". По умолчанию сокет находится в папке `/Applications/MAMP/tmp/mysql/mysql.sock`.
+
+
+[start=5]
+. Отображается диалоговое окно "Создать профиль нового экземпляра сервера". Выберите метод подключения "Локальный сокет/канал" и укажите путь к файлу сокета на вкладке "Параметры". По умолчанию сокет находится в папке `/Applications/MAMP/tmp/mysql/mysql.sock`.
+
image::images/socket-path.png[]
@@ -99,7 +119,7 @@ image::images/socket-path.png[]
Для создания проектов PHP в IDE с использованием ресурсов MAMP необходимо настроить IDE таким образом, чтобы она копировала ваши ресурсы в папку Apache `htdocs`. В этом случае при сохранении изменений в файлах будет автоматически обновляться исходный код развернутой версии.
-Например, можно создать новый проект PHP с помощью мастера новых проектов (нажмите значок "Создать проект" на панели инструментов IDE ( image::images/new-project-icon.png[] ). На третьем экране мастера "Конфигурация запуска" выберите параметр "Копировать файлы из исходной папки в другое расположение" и укажите путь к папке `htdocs`.
+Например, можно создать новый проект PHP с помощью мастера новых проектов (нажмите значок "Создать проект" на панели инструментов IDE ( image:images/new-project-icon.png[] ). На третьем экране мастера "Конфигурация запуска" выберите параметр "Копировать файлы из исходной папки в другое расположение" и укажите путь к папке `htdocs`.
[.feature]
--
@@ -118,9 +138,11 @@ IDE запоминает указанный путь и использует е
1. Откройте файл `php.ini` в редакторе. Этот файл находится в папке
`/Applications/MAMP/conf/php5/php.ini`.
-2. Найдите раздел ``[Zend]`` и закомментируйте в нем все строки.
-[source,java]
+[start=2]
+. Найдите раздел ``[Zend]`` и закомментируйте в нем все строки.
+
+[source,ini]
----
;[Zend]
@@ -130,9 +152,11 @@ IDE запоминает указанный путь и использует е
;zend_extension=/Applications/MAMP/bin/php5/zend/lib/ZendExtensionManager.so
----
-3. Найдите раздел ``[xdebug]`` и активируйте Xdebug (замените `xxxxxxxx` фактическим номером). Добавьте в конец файла ``php.ini`` следующий раздел (если он отсутствует).
-[source,java]
+[start=3]
+. Найдите раздел ``[xdebug]`` и активируйте Xdebug (замените `xxxxxxxx` фактическим номером). Добавьте в конец файла ``php.ini`` следующий раздел (если он отсутствует).
+
+[source,ini]
----
[xdebug]
@@ -148,17 +172,27 @@ xdebug.remote_autostart=1
zend_extension="/Applications/MAMP/bin/php5/lib/php/extensions/no-debug-non-zts-xxxxxxxx/xdebug.so"
----
Пояснения см. в разделе "Связанные настройки" документа link:http://www.Xdebug.org/docs/remote[+Удаленная отладка Xdebug+].
-4. Обратите внимание, что на предыдущем этапе был указан удаленный порт Xdebug 9000. Этот порт отладчика используется в NetBeans по умолчанию. Чтобы проверить номер порта, выберите "NetBeans > Предпочтения" в главном меню, затем выберите PHP в окне "Параметры".
- image::images/php-options68.png[title="Порт отладки можно указать в окне "Параметры PHP""]
+
+[start=4]
+. Обратите внимание, что на предыдущем этапе был указан удаленный порт Xdebug 9000. Этот порт отладчика используется в NetBeans по умолчанию. Чтобы проверить номер порта, выберите "NetBeans > Предпочтения" в главном меню, затем выберите PHP в окне "Параметры".
+
+image::images/php-options68.png[title="Порт отладки можно указать в окне "Параметры PHP""]
+
При необходимости здесь можно изменить порт отладчика.
-5. Откройте панель управления MAMP и перейдите на вкладку "PHP". Снимите флажок для параметра Zend Optimizer.
+
+[start=5]
+. Откройте панель управления MAMP и перейдите на вкладку "PHP". Снимите флажок для параметра Zend Optimizer.
+
image::images/mamp-control-panel-preferences-php.png[title="Панель управления MAMP со вкладкой "Порты", на которой установлены значения портов по умолчанию"]
-6. Запустите (или перезапустите) сервер Apache MAMP.
+
+
+[start=6]
+. Запустите (или перезапустите) сервер Apache MAMP.
== Отладка проектов PHP
-Чтобы выполнить отладку проекта PHP в IDE, щелкните проект правой кнопкой мыши в окне "Проекты" и выберите "Отладка". Также, если проект выбран в окне "Проекты", можно нажать значок "Отладка проекта" ( image::images/debug-icon.png[] ) на основной панели инструментов.
+Чтобы выполнить отладку проекта PHP в IDE, щелкните проект правой кнопкой мыши в окне "Проекты" и выберите "Отладка". Также, если проект выбран в окне "Проекты", можно нажать значок "Отладка проекта" ( image:images/debug-icon.png[] ) на основной панели инструментов.
Если требуется временно приостановить отладчик на первой строке кода, включите соответствующий параметр в окне <<phpOptions,Параметры PHP>>.
diff --git a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os_zh_CN.asciidoc
index c9fc05e..c72b38e 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-mac-os_zh_CN.asciidoc
@@ -51,20 +51,31 @@ image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 Net
|link:http://www.Xdebug.org/download.php[+Xdebug+]（可选） |2.x
|===
-*注：*MAMP 包中包含 Apache Web 服务器、PHP 引擎和 MySQL 数据库。Mac OS X 10.5 及更高版本包含支持 PHP 的 MySQL 数据库和 Apache 服务器。尽管确定可以使用 IDE 配置内置的数据库和服务器，但是 MAMP 的集功能于一身的包提供了一种简便轻松的可配置解决方案。
+NOTE: MAMP 包中包含 Apache Web 服务器、PHP 引擎和 MySQL 数据库。Mac OS X 10.5 及更高版本包含支持 PHP 的 MySQL 数据库和 Apache 服务器。尽管确定可以使用 IDE 配置内置的数据库和服务器，但是 MAMP 的集功能于一身的包提供了一种简便轻松的可配置解决方案。
== 安装和配置 MAMP
1. 下载最新版本的 link:http://www.mamp.info/en/download.html[+MAMP+]。
2. 提取下载的文件并运行 `.dmg` 文件。当安装程序显示时，将 MAMP 拖到 `/Applications` 文件夹中。
+
image::images/mamp-install.png[title="显示 MAMP 和 MAMP-Pro 选项的 MAMP 安装程序面板"]
-3. 导航到 `/Applications/MAMP` 并双击 `MAMP.app`。此时将打开 MAMP 控制面板。
+
+
+[start=3]
+. 导航到 `/Applications/MAMP` 并双击 `MAMP.app`。此时将打开 MAMP 控制面板。
您还可以按照 `MAMP/README.rtf` 中所述安装 MAMP 控制板窗口部件，这使您能够启动和停止服务器。
+
image::images/mamp-control-panel.png[]
-4. 单击 "Preferences"（首选项）打开 "Preferences"（首选项）面板，然后选择 "Ports"（端口）标签。
-5. 单击 "Set to Default Apache and MySQL ports"（设置为默认的 Apache 和 MySQL 端口）。Apache 端口将重置为 80，MySQL 端口将重置为 3306。
+
+
+[start=4]
+. 单击 "Preferences"（首选项）打开 "Preferences"（首选项）面板，然后选择 "Ports"（端口）标签。
+
+[start=5]
+. 单击 "Set to Default Apache and MySQL ports"（设置为默认的 Apache 和 MySQL 端口）。Apache 端口将重置为 80，MySQL 端口将重置为 3306。
+
image::images/mamp-control-panel-preferences-ports.png[title="在端口已更改为默认值之后带有 "Ports"（端口）标签的 MAMP 控制面板"]
@@ -81,16 +92,29 @@ IDE 从 "Services"（服务）窗口（⌘-5 组合键）中与数据库进行
* *Server Port Number（服务器端口号）：*`3306`
* *Administrator User Name（管理员用户名）：*`root`
* *Administrator Password（管理员口令）：*`root`
+
image::images/mysql-basic-properties.png[title="包含 MAMP 默认连接设置的 "MySQL Basic Properties"（MySQL 基本属性）对话框"]
-3. 选择 "Admin Properties"（管理属性）标签以显示可用于从 IDE 中启动和停止数据库服务器的设置。MAMP 在 `bin` 文件夹中维护 Shell 脚本。可以在此文件夹中查找用于启动和停止服务器的脚本。您可以选择管理工具的路径；可以链接到 `MAMP.app`，这样您就可以使用 IDE 打开 MAMP 的控制面板。为此，请输入 `/Applications/MAMP/MAMP.app`。但是，替代选项将使用 link:http://dev.mysql.com/downloads/workbench/[+MySQL Workbench+]，它提供用于执行管理操作（即，配置和监视 MySQL 服务器，管理用户和连接，执行备份等）的直观 GUI 界面。要使用 MySQL Workbench，请先下载并安装它，然后在对话框中输入以下设置：
+
+
+[start=3]
+. 选择 "Admin Properties"（管理属性）标签以显示可用于从 IDE 中启动和停止数据库服务器的设置。MAMP 在 `bin` 文件夹中维护 Shell 脚本。可以在此文件夹中查找用于启动和停止服务器的脚本。您可以选择管理工具的路径；可以链接到 `MAMP.app`，这样您就可以使用 IDE 打开 MAMP 的控制面板。为此，请输入 `/Applications/MAMP/MAMP.app`。但是，替代选项将使用 link:http://dev.mysql.com/downloads/workbench/[+MySQL Workbench+]，它提供用于执行管理操作（即，配置和监视 MySQL 服务器，管理用户和连接，执行备份等）的直观 GUI 界面。要使用 MySQL Workbench，请先下载并安装它，然后在对话框中输入以下设置：
* *管理工具的路径/URL：*`/Applications/MySQL Tools/MySQLWorkbench.app` _（MySQL Workbench 的默认安装）_
* *启动命令的路径：*`/Applications/MAMP/bin/startMysql.sh`
* *停止命令的路径：*`/Applications/MAMP/bin/stopMysql.sh`
+
image::images/mysql-admin-props.png[title="包含样例管理设置的 "MySQL Admin Properties"（MySQL 管理属性）对话框"]
-4. 如果选择使用 MySQL Workbench 作为 MySQL 管理工具，则需要指定用于 MAMP 数据库连接的套接字。启动 MySQL Workbench，然后从主页中，单击 "Server Administration"（服务器管理）列中的 "New Server Instance"（新建服务器实例）。
+
+
+[start=4]
+. 如果选择使用 MySQL Workbench 作为 MySQL 管理工具，则需要指定用于 MAMP 数据库连接的套接字。启动 MySQL Workbench，然后从主页中，单击 "Server Administration"（服务器管理）列中的 "New Server Instance"（新建服务器实例）。
+
image::images/mysql-workbench-home.png[]
-5. 此时将打开 "Create New Server Instance Profile"（新建服务器实例配置文件）对话框。选择 "Local Socket/Pipe"（本地套接字/管道）连接方法，并在 "Parameters"（参数）标签中添加套接字文件的路径。套接字的默认位置为：`/Applications/MAMP/tmp/mysql/mysql.sock`。
+
+
+[start=5]
+. 此时将打开 "Create New Server Instance Profile"（新建服务器实例配置文件）对话框。选择 "Local Socket/Pipe"（本地套接字/管道）连接方法，并在 "Parameters"（参数）标签中添加套接字文件的路径。套接字的默认位置为：`/Applications/MAMP/tmp/mysql/mysql.sock`。
+
image::images/socket-path.png[]
@@ -99,7 +123,7 @@ image::images/socket-path.png[]
在 IDE 中使用 MAMP 资源创建 PHP 项目时，应指定 IDE 将源复制到 Apache 的 `htdocs` 文件夹中。这样，当您在进行更改之后保存文件时，会自动在已部署版本中更新源。
-例如，创建新的 PHP 项目时，使用新建项目向导（在 IDE 的工具栏中单击 "New Project"（新建项目）图标）(image::images/new-project-icon.png[])。在此向导的第三步 "Run Configuration"（运行配置）中，选择 "Copy files from Sources Folder to anotherlocation"（将源文件夹中的文件复制到其他位置）选项，并键入 `htdocs` 文件夹的路径。
+例如，创建新的 PHP 项目时，使用新建项目向导（在 IDE 的工具栏中单击 "New Project"（新建项目）图标）(image:images/new-project-icon.png[])。在此向导的第三步 "Run Configuration"（运行配置）中，选择 "Copy files from Sources Folder to anotherlocation"（将源文件夹中的文件复制到其他位置）选项，并键入 `htdocs` 文件夹的路径。
[.feature]
--
@@ -118,9 +142,11 @@ MAMP 包含预编译的 ``xdebug.so`` 文件。要使用此文件，请在 MAM
1. 在编辑器中打开 `php.ini` 文件。此文件位于：
`/Applications/MAMP/conf/php5/php.ini`。
-2. 找到 ``[Zend]`` 部分并注释掉每一行。
-[source,java]
+[start=2]
+. 找到 ``[Zend]`` 部分并注释掉每一行。
+
+[source,ini]
----
;[Zend]
@@ -130,9 +156,11 @@ MAMP 包含预编译的 ``xdebug.so`` 文件。要使用此文件，请在 MAM
;zend_extension=/Applications/MAMP/bin/php5/zend/lib/ZendExtensionManager.so
----
-3. 找到 ``[xdebug]`` 部分并激活 Xdebug（将 `xxxxxxxx` 替换为实际数字）。将此部分添加到 ``php.ini`` 结尾（如果不存在）。
-[source,java]
+[start=3]
+. 找到 ``[xdebug]`` 部分并激活 Xdebug（将 `xxxxxxxx` 替换为实际数字）。将此部分添加到 ``php.ini`` 结尾（如果不存在）。
+
+[source,ini]
----
[xdebug]
@@ -148,17 +176,27 @@ xdebug.remote_autostart=1
zend_extension="/Applications/MAMP/bin/php5/lib/php/extensions/no-debug-non-zts-xxxxxxxx/xdebug.so"
----
有关这些属性的说明，请参见 link:http://www.Xdebug.org/docs/remote[+Xdebug 远程调试+]文档中的“相关设置”。
-4. 请注意，在上一步中为 Xdebug 指定的远程端口为：9000。这是在 NetBeans 中使用的默认调试器端口。要对此进行验证，请从主菜单中选择 "NetBeans" > "Preferences"（首选项），然后在 "Options"（选项）窗口中选择 "PHP"。
- image::images/php-options68.png[title="可以在 "PHP Options"（PHP 选项）窗口中设置调试端口"]
+
+[start=4]
+. 请注意，在上一步中为 Xdebug 指定的远程端口为：9000。这是在 NetBeans 中使用的默认调试器端口。要对此进行验证，请从主菜单中选择 "NetBeans" > "Preferences"（首选项），然后在 "Options"（选项）窗口中选择 "PHP"。
+
+image::images/php-options68.png[title="可以在 "PHP Options"（PHP 选项）窗口中设置调试端口"]
+
如果需要，您可以在此处更改调试器端口。
-5. 打开 MAMP 控制面板并选择 "PHP" 标签。取消选择 "Zend Optimizer"（Zend 优化器）。
+
+[start=5]
+. 打开 MAMP 控制面板并选择 "PHP" 标签。取消选择 "Zend Optimizer"（Zend 优化器）。
+
image::images/mamp-control-panel-preferences-php.png[title="取消选择 "Zend Optimizer"（Zend 优化器）之后带有 "PHP" 标签的 MAMP 控制面板"]
-6. 启动（或重新启动）MAMP Apache 服务器。
+
+
+[start=6]
+. 启动（或重新启动）MAMP Apache 服务器。
== 调试 PHP 项目
-要在 IDE 中调试 PHP 项目，请在 "Projects"（项目）窗口中右键单击该项目并选择 "Debug"（调试）。或者，如果在 "Projects"（项目）窗口中突出显示了该项目，可以单击主工具栏中的 "Debug Project"（调试项目）图标 (image::images/debug-icon.png[])。
+要在 IDE 中调试 PHP 项目，请在 "Projects"（项目）窗口中右键单击该项目并选择 "Debug"（调试）。或者，如果在 "Projects"（项目）窗口中突出显示了该项目，可以单击主工具栏中的 "Debug Project"（调试项目）图标 (image:images/debug-icon.png[])。
通过在 <<phpOptions,"PHP Options"（PHP 选项）窗口>>中启用此选项，可以将调试器设置为在第一行代码处挂起。
diff --git a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu.asciidoc
index dc893f2..6dbf48f 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu.asciidoc
@@ -153,7 +153,7 @@ sudo cp /etc/apache2/sites-available/default /etc/apache2/sites-available/mysite
----
[start=3]
-3. Run the ``gedit`` application and edit the new configuration file ( ``mysite`` ) in it:
+. Run the ``gedit`` application and edit the new configuration file ( ``mysite`` ) in it:
[source,bash]
----
@@ -163,7 +163,7 @@ gksudo gedit /etc/apache2/sites-available/mysite
If asked, enter the password that you specified for the root user during the installation of your operating system.
[start=4]
-4. Change the Document Root to point to the new location:
+. Change the Document Root to point to the new location:
[source,bash]
----
@@ -172,7 +172,7 @@ If asked, enter the password that you specified for the root user during the ins
----
[start=5]
-5. Change the Directory directive, replace
+. Change the Directory directive, replace
[source,ini]
----
@@ -190,7 +190,7 @@ with
image::images/ubuntu-change-directory-root.png[]
[start=6]
-6. Save the file ``mysite``
+. Save the file ``mysite``
==== Activating the New Virtual Host
@@ -203,7 +203,7 @@ sudo a2dissite default && sudo a2ensite mysite
----
[start=2]
-2. Restart the Apache HTTP server:
+. Restart the Apache HTTP server:
[source,bash]
----
@@ -225,7 +225,7 @@ mysql -u root -p
The MySQL command prompt appears.
[start=2]
-2. At the command prompt enter the following command and press Enter:
+. At the command prompt enter the following command and press Enter:
[source,sql]
----
@@ -261,15 +261,15 @@ To build XDebug from sources you need two additional modules: PHP5 Development a
For each item, from the context menu choose Mark for installation.
[start=4]
-4. The Mark additional required changes dialog box opens with a list of dependent packages that should be also installed to enable the work of the software. Click Mark.
-5. The system returns to the Synaptic Package Manager panel where the selected packages are marked for installation.
-6. Choose Apply on the toolbar. The Apply the following changes summary panel opens with a list of packages selected for installation. Click Apply.
-7. When the download and installation are completed successfully, the Changes applied panel opens. Click Close.
+. The Mark additional required changes dialog box opens with a list of dependent packages that should be also installed to enable the work of the software. Click Mark.
+. The system returns to the Synaptic Package Manager panel where the selected packages are marked for installation.
+. Choose Apply on the toolbar. The Apply the following changes summary panel opens with a list of packages selected for installation. Click Apply.
+. When the download and installation are completed successfully, the Changes applied panel opens. Click Close.
NOTE: You can also install the modules by running the following command in the Terminal window: ``aptitude install php5-dev php-pear``
[start=8]
-8. You can now download and install XDebug. Enter the following command in the Terminal window:
+. You can now download and install XDebug. Enter the following command in the Terminal window:
[source,bash]
----
@@ -291,8 +291,8 @@ gksudo gedit
If asked, enter the password specified for the root user during the installation of your operating system.
[start=2]
-2. Open the file ``/etc/php5/apache2/php.ini`` .
-3. Add the following lines to the file:
+. Open the file ``/etc/php5/apache2/php.ini`` .
+. Add the following lines to the file:
[source,ini]
----
diff --git a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu_ja.asciidoc
index 3085ff2..bff090c 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu_ja.asciidoc
@@ -32,9 +32,6 @@
このチュートリアルでは、Ubuntuオペレーティング・システム(7.10以降)でPHP開発環境を構成する方法を示します。これには、PHPエンジン、MySQLデータベース、Apache Webサーバー、およびXDebugデバッガのインストールと構成が含まれます。
-image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、NetBeans IDE 7.2、7.3、7.4および8.0に適用されます"]
-
-
*このチュートリアルに従うには、次のソフトウェアとリソースが必要です。*
|===
@@ -74,7 +71,7 @@ Apache、MySQL、およびPHPのインストールについては、link:https:/
Ubuntuには、PHP環境に必要なパッケージがすべて含まれるLinux AMP (LAMP)パッケージがあります。ターミナル・ウィンドウのコマンド・プロンプトで次のコマンドを実行することで、ソフトウェアをインストールできます。
-[source,java]
+[source,bash]
----
sudo tasksel install lamp-server
@@ -104,6 +101,7 @@ LAMPパッケージのセット全体をインストールするかわりに、
PHP Web Stackを設定した後に、正しくインストールされていること、およびApacheサーバーでPHPエンジンが認識されていることを確認します。
ApacheとPHPがインストールされ、実行されていることを確認するには、NetBeans IDEを開き、link:./project-setup.html[+PHPプロジェクトを作成+]します。 ``index.php`` ファイルに、PHPメソッド ``phpinfo()`` を入力します。ファイルを実行します。標準のPHP情報ページが表示されます。
+
image::images/ubuntu-phpinfo.png[]
@@ -115,7 +113,7 @@ image::images/ubuntu-phpinfo.png[]
* *ブラウザ・ウィンドウに ``~USER/PROJECT/index.php`` が見つからないというエラーが表示される。*URLから文字列 ``~USER`` を除去します。たとえば、URLが ``~ubuntu/test1/index.php`` のときにこのエラーが表示される場合は、URLを ``test1/index.php`` に変更します。PHPプロジェクトのURLは、NetBeans IDEでプロジェクトを作成するときに、またはプロジェクト・ノードを右クリックして「プロパティ」>「実行構成」を選択することで設定できます。
* *PHPエンジンが認識されていないかのように、ブラウザのポップアップが表示され、ファイルを開くように求められる。* ``php5-common`` パッケージに問題があります。 ``php5`` と ``phpmyadmin`` に置き換えます。 ``php5-common`` を置き換えるには、次の2つのコマンドを実行します。
-[source,java]
+[source,bash]
----
apt-get --purge remove php5-commonapt-get install php5 phpmyadmin
@@ -127,7 +125,7 @@ apt-get --purge remove php5-commonapt-get install php5 phpmyadmin
ドキュメント・ルートは、Apache HTTPサーバーがブラウザで表示するファイルを取得するディレクトリです。ドキュメント・ルートは、仮想ホストを定義するファイルで指定されます。デフォルトの仮想ホストの構成ファイルは次のとおりです。
-[source,java]
+[source,bash]
----
/etc/apache2/sites-available/default
@@ -136,7 +134,7 @@ apt-get --purge remove php5-commonapt-get install php5 phpmyadmin
ドキュメント・ルートは次のとおりです。
-[source,java]
+[source,bash]
----
/var/www/
@@ -161,56 +159,68 @@ apt-get --purge remove php5-commonapt-get install php5 phpmyadmin
1. ターミナルを起動するには、「アプリケーション」>「アクセサリ」>「ターミナル」を選択します。ターミナル・ウィンドウが開きます。
2. デフォルトの仮想ホストの構成ファイルを新しいファイル( ``mysite`` )にコピーするには、コマンド・プロンプトで次のコマンドを入力します。
-[source,java]
+[source,bash]
----
sudo cp /etc/apache2/sites-available/default /etc/apache2/sites-available/mysite
----
-3. ``gedit`` アプリケーションを実行し、そこで新しい構成ファイル( ``mysite`` )を編集します。
-[source,java]
+[start=3]
+. ``gedit`` アプリケーションを実行し、そこで新しい構成ファイル( ``mysite`` )を編集します。
+
+[source,bash]
----
gksudo gedit /etc/apache2/sites-available/mysite
----
要求された場合は、オペレーティング・システムのインストール時にルート・ユーザー用に指定したパスワードを入力します。
-4. ドキュメント・ルートを変更し、新しい場所を指定します。
-[source,java]
+[start=4]
+. ドキュメント・ルートを変更し、新しい場所を指定します。
+
+[source,bash]
----
/home/<user>/public_html/
----
-5. Directoryディレクティブを変更します。
-[source,java]
+[start=5]
+. Directoryディレクティブを変更します。
+
+[source,bash]
----
<Directory /var/www/>
----
次と置き換えます。
-[source,java]
+[source,bash]
----
<Directory /home/user/public_html/>
----
+
image::images/ubuntu-change-directory-root.png[]
-6. ファイル ``mysite`` を保存します。
+
+
+[start=6]
+. ファイル ``mysite`` を保存します。
=== 新規仮想ホストのアクティブ化
1. デフォルトのホストを非アクティブ化し、新しいホストをアクティブ化するには、<<launchTerminal,ターミナルを起動>>し、ターミナル・ウィンドウで次の2つのユーティリティを実行します。
-[source,java]
+[source,bash]
----
sudo a2dissite default && sudo a2ensite mysite
----
-2. Apache HTTPサーバーを再起動します。
-[source,java]
+[start=2]
+. Apache HTTPサーバーを再起動します。
+
+[source,bash]
----
sudo /etc/init.d/apache2 reload
@@ -221,24 +231,28 @@ sudo /etc/init.d/apache2 reload
MySQLデータベース・サーバーのインストール時に、ルート・ユーザーが作成されます。インストール中に、ルート・ユーザーのパスワードを設定するダイアログが開きます。このダイアログが開かなかったか、このダイアログでパスワードを設定しなかった場合は、MySQLのルート・ユーザーのパスワードを今すぐ作成する必要があります。他のMySQLサーバー・ユーザーを作成するには、パスワードが必要になります。
-1. MySQLサーバーに接続するには、<<launchTerminal,ターミナルを起動>>し、ターミナル・ウィンドウで次のコマンドを入力します。
-[source,java]
+[start=1]
+. MySQLサーバーに接続するには、<<launchTerminal,ターミナルを起動>>し、ターミナル・ウィンドウで次のコマンドを入力します。
+
+[source,bash]
----
mysql -u root -p
----
MySQLコマンド・プロンプトが表示されます。
-2. コマンド・プロンプトで次のコマンドを入力し、[Enter]を押します。
-[source,java]
+[start=2]
+. コマンド・プロンプトで次のコマンドを入力し、[Enter]を押します。
+
+[source,sql]
----
SET PASSWORD FOR 'root'@'localhost' = PASSWORD('<yourpassword>');
----
コマンドが正常に実行されると、次のメッセージが表示されます。
-[source,java]
+[source,bash]
----
Query OK, 0 rows affected (0.00 sec)
@@ -266,16 +280,26 @@ Ubuntu 8.05以降では、 ``php5-xdebug`` というXDebugパッケージが使
* php5-dev
* php-pear
各項目で、コンテキスト・メニューからインストールの「マーク」を選択します。
-4. 依存パッケージの一覧が表示された「依存により要求された変更を追加しますか?」ダイアログ・ボックスが開きます(依存パッケージも、ソフトウェアの機能を有効にするためにインストールされます)。「マーク」をクリックします。
-5. システムが「Synapticパッケージ・マネージャ」パネルに戻ると、選択したパッケージにインストールのマークが付いています。
-6. ツールバーで「適用」を選択します。インストール対象として選択したパッケージの一覧が表示された「次の変更を適用のサマリー」パネルが開きます。「適用」をクリックします。
-7. ダウンロードとインストールが正常に完了したら、「変更を適用」パネルが開きます。「閉じる」をクリックします。
-*注意:* ターミナル・ウィンドウで次のコマンドを実行することで、モジュールをインストールすることもできます。 ``aptitude install php5-dev php-pear``
+[start=4]
+. 依存パッケージの一覧が表示された「依存により要求された変更を追加しますか?」ダイアログ・ボックスが開きます(依存パッケージも、ソフトウェアの機能を有効にするためにインストールされます)。「マーク」をクリックします。
+
+[start=5]
+. システムが「Synapticパッケージ・マネージャ」パネルに戻ると、選択したパッケージにインストールのマークが付いています。
+
+[start=6]
+. ツールバーで「適用」を選択します。インストール対象として選択したパッケージの一覧が表示された「次の変更を適用のサマリー」パネルが開きます。「適用」をクリックします。
+
+[start=7]
+. ダウンロードとインストールが正常に完了したら、「変更を適用」パネルが開きます。「閉じる」をクリックします。
-8. これでXDebugをダウンロードし、インストールできます。ターミナル・ウィンドウに次のコマンドを入力します。
+NOTE: ターミナル・ウィンドウで次のコマンドを実行することで、モジュールをインストールすることもできます。 ``aptitude install php5-dev php-pear``
-[source,java]
+
+[start=8]
+. これでXDebugをダウンロードし、インストールできます。ターミナル・ウィンドウに次のコマンドを入力します。
+
+[source,bash]
----
sudo pecl install xdebug
@@ -288,16 +312,20 @@ XDebugを有効にするには、<<gedit, ``gedit`` >>テキスト・プロセ
1. ``gedit`` テキスト・プロセッサを起動するには、<<launchTerminal,ターミナル>>を起動し、コマンド・プロンプトで次のコマンドを入力します。
-[source,java]
+[source,bash]
----
gksudo gedit
----
要求された場合は、オペレーティング・システムのインストール時にルート・ユーザー用に指定したパスワードを入力します。
-2. ファイル ``/etc/php5/apache2/php.ini`` を開きます。
-3. ファイルに次の行を追加します。
-[source,java]
+[start=2]
+. ファイル ``/etc/php5/apache2/php.ini`` を開きます。
+
+[start=3]
+. ファイルに次の行を追加します。
+
+[source,ini]
----
zend_extension=/usr/lib/php5/<DATE+lfs>/xdebug.so
diff --git a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu_pt_BR.asciidoc
index d774e00..4c16bea 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu_pt_BR.asciidoc
@@ -32,9 +32,6 @@
Este tutorial mostra como configurar o ambiente de desenvolvimento do PHP no sistema operacional Ubuntu (7.10 ou superior) Isso envolve a instalação e configuração do mecanismo PHP, um banco de dados MySQL, um servidor web Apache e o depurador XDebug.
-image::images/netbeans-stamp-80-74-73.png[title="O conteúdo desta página se aplica ao NetBeans IDE 7.2, 7.3, 7.4 e 8.0"]
-
-
*Para seguir este tutorial, são necessários os recursos e o software a seguir.*
|===
@@ -74,7 +71,7 @@ Consulte a link:https://help.ubuntu.com/community/ApacheMySQLPHP[+comunidade Ubu
O Ubuntu oferece um pacote Linux AMP (LAMP) que contém todos os pacotes necessários para o ambiente PHP. Você pode instalar o software executando o seguinte comando no prompt de comando na janela Terminal:
-[source,java]
+[source,bash]
----
sudo tasksel install lamp-server
@@ -104,6 +101,7 @@ Os pacotes individuais a serem instalados são os seguintes:
Após configurar sua pilha web de PHP, verifique se ela está instalada corretamente e se o servidor Apache reconhece o mecanismo PHP.
Para verificar se Apache e PHP estão instalados e em execução, abra o NetBeans IDE e link:./project-setup.html[+crie um projeto PHP+]. No arquivo ``index.php`` , insira o método PHP ``phpinfo()`` . Execute o arquivo. A página de informações do PHP padrão deverá ser exibida.
+
image::images/ubuntu-phpinfo.png[]
@@ -115,7 +113,7 @@ A seguir estão alguns dos problemas encontrados com frequência ao verificar a
* *A janela do browser exibe a mensagem Erro Não Encontrado para ``~USER/PROJECT/index.php`` *. Remova a string ``~USER`` do URL. Por exemplo, se este erro for exibido para o URL ``~ubuntu/test1/index.php`` , altere o URL para ``test1/index.php`` . Observe que você pode definir o URL de um projeto PHP no NetBeans IDE ao criar o projeto ou clicando com botão direito do mouse no nó do projeto e indo a Propriedades > Executar Configuração.
* *O browser mostra um pop-up pedindo para abrir o arquivo, como se o mecanismo PHP não tivesse sido reconhecido.* Há um problema com o pacote ``php5-common`` . Substitua-o por ``php5`` e ``phpmyadmin`` . Para substituir o ``php5-common`` , execute os dois comandos a seguir:
-[source,java]
+[source,bash]
----
apt-get --purge remove php5-commonapt-get install php5 phpmyadmin
@@ -127,7 +125,7 @@ apt-get --purge remove php5-commonapt-get install php5 phpmyadmin
A raiz do documento é o diretório onde o servidor HTTP Apache coloca os arquivos para exibição no browser. A Raiz do Documento é especificada no arquivo que define seu host virtual. O arquivo de configuração de host virtual default é
-[source,java]
+[source,bash]
----
/etc/apache2/sites-available/default
@@ -136,7 +134,7 @@ A raiz do documento é o diretório onde o servidor HTTP Apache coloca os arquiv
com a raiz do documento
-[source,java]
+[source,bash]
----
/var/www/
@@ -162,57 +160,69 @@ Recomendamos que você crie seu próprio host virtual e o ative, em vez de edita
acionar o Terminal, selecione Aplicações > Acessórios > Terminal. A janela Terminal será aberta.
2. Para copiar o arquivo de configuração do host virtual default para um novo arquivo ( ``mysite`` ), digite o seguinte comando no prompt de comando:
-[source,java]
+[source,bash]
----
sudo cp /etc/apache2/sites-available/default /etc/apache2/sites-available/mysite
----
-3. Execute a aplicação ``
+
+[start=3]
+. Execute a aplicação ``
gedit`` e edite o novo arquivo de configuração ( ``mysite`` ) nela:
-[source,java]
+[source,bash]
----
gksudo gedit /etc/apache2/sites-available/mysite
----
Se solicitado, digite a senha especificada para o usuário raiz durante a instalação do sistema operacional.
-4. Altere a Raiz do Documento para apontar para o novo local:
-[source,java]
+[start=4]
+. Altere a Raiz do Documento para apontar para o novo local:
+
+[source,bash]
----
/home/<user>/public_html/
----
-5. Alterar a diretiva Directory, substituir
-[source,java]
+[start=5]
+. Alterar a diretiva Directory, substituir
+
+[source,bash]
----
<Directory /var/www/>
----
por
-[source,java]
+[source,bash]
----
<Directory /home/user/public_html/>
----
+
image::images/ubuntu-change-directory-root.png[]
-6. Salvar o arquivo ``mysite``
+
+
+[start=6]
+. Salvar o arquivo ``mysite``
=== Ativando o Novo Host Virtual
1. Para desativar o host default e ativar o novo host, <<launchTerminal,acione o Terminal>> e execute os dois utilitários a seguir na janela Terminal:
-[source,java]
+[source,bash]
----
sudo a2dissite default && sudo a2ensite mysite
----
-2. Reinicie o servidor HTTP Apache:
-[source,java]
+[start=2]
+. Reinicie o servidor HTTP Apache:
+
+[source,bash]
----
sudo /etc/init.d/apache2 reload
@@ -223,24 +233,28 @@ sudo /etc/init.d/apache2 reload
Durante a instalação do servidor de banco de dados MySQL, um usuário raiz é criado. Durante a instalação, é exibida uma caixa de diálogo na qual você define a senha de usuário raiz. Se essa caixa de diálogo não tiver aberto ou se você não tiver definido uma senha nessa caixa de diálogo, terá que criar uma senha de usuário raiz MySQL agora. Você precisará da senha para criar outros usuários do servidor MySQL.
-1. Para se conectar ao servidor MySQL,<<launchTerminal, acione o Terminal>> e na janela Terminal, insira o seguinte comando:
-[source,java]
+[start=1]
+. Para se conectar ao servidor MySQL,<<launchTerminal, acione o Terminal>> e na janela Terminal, insira o seguinte comando:
+
+[source,bash]
----
mysql -u root -p
----
O prompt de comando do MySQL será exibido.
-2. No prompt de comando, digite o seguinte comando e pressione Enter:
-[source,java]
+[start=2]
+. No prompt de comando, digite o seguinte comando e pressione Enter:
+
+[source,sql]
----
SET PASSWORD FOR 'root'@'localhost' = PASSWORD('<yourpassword>');
----
Se o comando for executado com sucesso, a seguinte mensagem será exibida:
-[source,java]
+[source,bash]
----
Query OK, 0 rows affected (0.00 sec)
@@ -268,16 +282,26 @@ Para construir o XDebug usando Códigos-Fonte, você precisa de dois módulos ad
* php5-dev
* php-pear
Para cada item, no menu de contexto, selecione Marcar para instalação.
-4. A caixa de diálogo Marcar alterações adicionais necessárias será aberta com uma lista dos pacotes dependentes que também devem ser instalados para permitir o trabalho do software. Clique em Marcar.
-5. O sistema retornará para o painel Gerenciador do Pacote Synaptic onde os pacotes selecionados estão marcados para instalação.
-6. Selecione Aplicar na barra de ferramentas. O painel de resumo Aplicar as seguintes alterações será aberto com uma lista dos pacotes selecionados para instalação. Clique em Aplicar.
-7. Quando o download e a instalação forem concluídos com êxito, o painel Alterações aplicadas será aberto. Clique em Fechar.
-*Observação:* você também pode instalar os módulos executando o seguinte comando na janela Terminal: ``aptitude install php5-dev php-pear``
+[start=4]
+. A caixa de diálogo Marcar alterações adicionais necessárias será aberta com uma lista dos pacotes dependentes que também devem ser instalados para permitir o trabalho do software. Clique em Marcar.
+
+[start=5]
+. O sistema retornará para o painel Gerenciador do Pacote Synaptic onde os pacotes selecionados estão marcados para instalação.
+
+[start=6]
+. Selecione Aplicar na barra de ferramentas. O painel de resumo Aplicar as seguintes alterações será aberto com uma lista dos pacotes selecionados para instalação. Clique em Aplicar.
+
+[start=7]
+. Quando o download e a instalação forem concluídos com êxito, o painel Alterações aplicadas será aberto. Clique em Fechar.
-8. Agora você pode fazer o download e instalar o XDebug. Digite o seguinte comando na janela Terminal:
+NOTE: você também pode instalar os módulos executando o seguinte comando na janela Terminal: ``aptitude install php5-dev php-pear``
-[source,java]
+
+[start=8]
+. Agora você pode fazer o download e instalar o XDebug. Digite o seguinte comando na janela Terminal:
+
+[source,bash]
----
sudo pecl install xdebug
@@ -290,16 +314,20 @@ Para ativar o XDebug, você precisa editar o arquivo php.ini no processador de t
1. Para iniciar o processador de texto ``gedit`` , acione o <<launchTerminal,Terminal>> e digite o seguinte comando no prompt de comando:
-[source,java]
+[source,bash]
----
gksudo gedit
----
Se solicitado, informe a senha especificada para o usuário raiz durante a instalação do sistema operacional.
-2. Abra o arquivo ``/etc/php5/apache2/php.ini`` .
-3. Adicione as linhas a seguir ao arquivo:
-[source,java]
+[start=2]
+. Abra o arquivo ``/etc/php5/apache2/php.ini`` .
+
+[start=3]
+. Adicione as linhas a seguir ao arquivo:
+
+[source,ini]
----
zend_extension=/usr/lib/php5/<DATE+lfs>/xdebug.so
diff --git a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu_ru.asciidoc
index 3260467..502fd03 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu_ru.asciidoc
@@ -32,9 +32,6 @@
В данном учебном курсе рассматривается процедура настройки среды разработки PHP в операционной системе Ubuntu (версия 7.10 и более поздние). Эта процедура предполагает установку и настройку механизма PHP, базы данных MySQL, веб-сервера Apache и отладчика XDebug.
-image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой страницы применимо к IDE NetBeans 7.2, 7.3, 7.4 и 8.0"]
-
-
*Для работы с этим учебным курсом требуется следующее программное обеспечение и ресурсы.*
|===
@@ -74,7 +71,7 @@ image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой
Ubuntu предоставляет пакет Linux AMP (LAMP), который содержит все необходимые пакеты для среды PHP. Для установки программного обеспечения можно выполнить следующую команду в командной строке в окне терминала:
-[source,java]
+[source,bash]
----
sudo tasksel install lamp-server
@@ -104,6 +101,7 @@ sudo tasksel install lamp-server
После настройки пакета PHP Web Stack убедитесь в том, что он установлен правильно, а сервер Apache распознает механизм PHP.
Чтобы убедиться, что Apache и PHP установлены и запущены, откройте IDE NetBeans и link:./project-setup.html[+создайте проект PHP+]. В файле ``index.php`` введите метод PHP ``phpinfo()`` . Запустите файл. При этом должна отобразиться стандартная информационная страница PHP.
+
image::images/ubuntu-phpinfo.png[]
@@ -115,7 +113,7 @@ image::images/ubuntu-phpinfo.png[]
* *В окне браузера отображается ошибка "Not Found" для ``~USER/PROJECT/index.php`` *. Удалите строку ``~USER`` из URL-адреса. Например, если эта ошибка происходит для URL-адреса ``~ubuntu/test1/index.php`` , измените его на ``test1/index.php`` . Обратите внимание, что можно настроить адрес URL для проекта PHP в IDE NetBeans либо при создании проекта или путем щелчка правой кнопки мыши узла проекта и перехода в 'Свойства' > 'Запустить конфигурацию'.
* *В браузере отображается всплывающее окно с запросом на открытие файла, как если бы механизм PHP не распознавался.* Пакет ``php5-common`` содержит ошибку. Замените его пакетами ``php5`` и ``phpmyadmin`` . Для замены пакета ``php5-common`` необходимо выполнить следующие две команды:
-[source,java]
+[source,bash]
----
apt-get --purge remove php5-commonapt-get install php5 phpmyadmin
@@ -127,7 +125,7 @@ apt-get --purge remove php5-commonapt-get install php5 phpmyadmin
Корневой узел документов представляет собой папку, из которой сервер HTTP Apache извлекает файлы для отображения в браузере. Корневой узел документов указан в файле, определяющем виртуальный узел. Файл настройки, определяющий виртуальный узел по умолчанию:
-[source,java]
+[source,bash]
----
/etc/apache2/sites-available/default
@@ -136,7 +134,7 @@ apt-get --purge remove php5-commonapt-get install php5 phpmyadmin
с корневым узлом документов
-[source,java]
+[source,bash]
----
/var/www/
@@ -162,57 +160,69 @@ apt-get --purge remove php5-commonapt-get install php5 phpmyadmin
запуска терминала выберите "Applications>Accessories>Terminal". Откроется окно терминала.
2. Для копирования файла настройки из виртуального узла по умолчанию в новый файл ( ``mysite`` ) введите в командной строке следующую команду:
-[source,java]
+[source,bash]
----
sudo cp /etc/apache2/sites-available/default /etc/apache2/sites-available/mysite
----
-3. Запустите приложение ``
+
+[start=3]
+. Запустите приложение ``
gedit`` и отредактируйте в нем новый файл настройки ( ``mysite`` ):
-[source,java]
+[source,bash]
----
gksudo gedit /etc/apache2/sites-available/mysite
----
При появлении запроса введите пароль, определенный для пользователя root во время установки операционной системы.
-4. Измените корневой узел документов, указав в нем новое местоположение:
-[source,java]
+[start=4]
+. Измените корневой узел документов, указав в нем новое местоположение:
+
+[source,bash]
----
/home/<user>/public_html/
----
-5. Измените директиву Directory путем замены
-[source,java]
+[start=5]
+. Измените директиву Directory путем замены
+
+[source,bash]
----
<Directory /var/www/>
----
на
-[source,java]
+[source,bash]
----
<Directory /home/user/public_html/>
----
+
image::images/ubuntu-change-directory-root.png[]
-6. Сохраните файл ``mysite``
+
+
+[start=6]
+. Сохраните файл ``mysite``
=== Активация нового виртуального узла
1. Для отключения виртуального узла по умолчанию и включения нового узла <<launchTerminal,запустите терминал>> и выполните следующие служебные программы в окне терминала:
-[source,java]
+[source,bash]
----
sudo a2dissite default && sudo a2ensite mysite
----
-2. Перезапустите сервер HTTP Apache:
-[source,java]
+[start=2]
+. Перезапустите сервер HTTP Apache:
+
+[source,bash]
----
sudo /etc/init.d/apache2 reload
@@ -223,24 +233,28 @@ sudo /etc/init.d/apache2 reload
Во время установки сервера базы данных MySQL создается учетная запись пользователя root (администратора). В ходе установки открывается диалоговое окно, в котором требуется указать пароль пользователя root (администратора). Если это диалоговое окно не открылось или если в нем не был задан пароль, необходимо создать пароль пользователя root (администратора) MySQL сейчас. Этот пароль требуется для создания других пользователей сервера MySQL.
-1. Для подключения к серверу MySQL<<launchTerminal, запустите терминал>> и в окне терминала введите следующую команду:
-[source,java]
+[start=1]
+. Для подключения к серверу MySQL<<launchTerminal, запустите терминал>> и в окне терминала введите следующую команду:
+
+[source,bash]
----
mysql -u root -p
----
Появится командная строка MySQL.
-2. В этой командной строке введите следующую команду и нажмите ENTER:
-[source,java]
+[start=2]
+. В этой командной строке введите следующую команду и нажмите ENTER:
+
+[source,sql]
----
SET PASSWORD FOR 'root'@'localhost' = PASSWORD('<yourpassword>');
----
В случае успешного выполнения команды появляется следующее сообщение:
-[source,java]
+[source,bash]
----
Query OK, 0 rows affected (0.00 sec)
@@ -268,16 +282,26 @@ Query OK, 0 rows affected (0.00 sec)
* php5-dev
* php-pear
В контекстном меню для каждого элемента выберите "Mark for installation".
-4. Появится диалоговое окно "Mark additional required changes", содержащее список зависимых пакетов, установка которых также является необходимой для функционирования программного обеспечения. Нажмите кнопку "Mark".
-5. Происходит автоматический возврат к экрану "Synaptic Package Manager", на котором представлены выбранные пакеты, отмеченные для установки.
-6. На панели инструментов выберите "Apply". Появится экран "Apply the following changes summary" со списком пакетов, выбранных для установки. Нажмите кнопку "Apply".
-7. После успешного завершения загрузки и установки появляется экран "Changes applied". Выберите "Close" (Закрыть).
-*Примечание.* Модули также можно установить путем запуска следующей команды в окне 'Терминал': ``aptitude install php5-dev php-pear``
+[start=4]
+. Появится диалоговое окно "Mark additional required changes", содержащее список зависимых пакетов, установка которых также является необходимой для функционирования программного обеспечения. Нажмите кнопку "Mark".
+
+[start=5]
+. Происходит автоматический возврат к экрану "Synaptic Package Manager", на котором представлены выбранные пакеты, отмеченные для установки.
+
+[start=6]
+. На панели инструментов выберите "Apply". Появится экран "Apply the following changes summary" со списком пакетов, выбранных для установки. Нажмите кнопку "Apply".
+
+[start=7]
+. После успешного завершения загрузки и установки появляется экран "Changes applied". Выберите "Close" (Закрыть).
-8. После этого можно загрузить и установить отладчик XDebug. Введите следующую команду в окне "Terminal":
+NOTE: Модули также можно установить путем запуска следующей команды в окне 'Терминал': ``aptitude install php5-dev php-pear``
-[source,java]
+
+[start=8]
+. После этого можно загрузить и установить отладчик XDebug. Введите следующую команду в окне "Terminal":
+
+[source,bash]
----
sudo pecl install xdebug
@@ -290,16 +314,20 @@ sudo pecl install xdebug
1. Для запуска текстового процессора ``gedit`` запустите <<launchTerminal,терминал>> и в командной строке введите следующую команду:
-[source,java]
+[source,bash]
----
gksudo gedit
----
При появлении запроса введите пароль, определенный для пользователя root во время установки операционной системы.
-2. Откройте файл ``/etc/php5/apache2/php.ini`` .
-3. Добавьте в файл следующие строки:
-[source,java]
+[start=2]
+. Откройте файл ``/etc/php5/apache2/php.ini`` .
+
+[start=3]
+. Добавьте в файл следующие строки:
+
+[source,ini]
----
zend_extension=/usr/lib/php5/<DATE+lfs>/xdebug.so
diff --git a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu_zh_CN.asciidoc
index 6f475d0..2bdc022 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-ubuntu_zh_CN.asciidoc
@@ -32,9 +32,6 @@
本教程将介绍如何在 Ubuntu 操作系统（7.10 及更高版本）中配置 PHP 开发环境。其中包括安装和配置 PHP 引擎、MySQL 数据库、Apache Web 服务器和 XDebug 调试器。
-image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 NetBeans IDE 7.2、7.3、7.4 和 8.0"]
-
-
*要学习本教程，您需要具备以下软件和资源。*
|===
@@ -74,7 +71,7 @@ image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 Net
Ubuntu 提供了一个 Linux AMP (LAMP) 包，其中包含 PHP 环境所需的全部软件包。可通过在“终端”窗口的命令提示符下执行以下命令安装此软件：
-[source,java]
+[source,bash]
----
sudo tasksel install lamp-server
@@ -104,6 +101,7 @@ sudo tasksel install lamp-server
在设置 PHP Web 堆栈之后，应检查其安装是否正确，以及 Apache 服务器是否可以识别 PHP 引擎。
要检查 Apache 和 PHP 是否已安装并正在运行，请打开 NetBeans IDE 并link:./project-setup.html[+创建 PHP 项目+]。在 ``index.php`` 文件中，输入 PHP 方法 ``phpinfo()`` 。运行该文件。此时应显示标准 PHP 信息页。
+
image::images/ubuntu-phpinfo.png[]
@@ -115,7 +113,7 @@ image::images/ubuntu-phpinfo.png[]
* *浏览器窗口显示无法找到 ``~USER/PROJECT/index.php`` 错误*。从 URL 中删除 ``~USER`` 字符串。例如，如果 URL ``~ubuntu/test1/index.php`` 出现此错误，请将该 URL 更改为 ``test1/index.php`` 。请注意，您既可以在 NetBeans IDE 中创建 PHP 项目时为该项目设置 URL，也可以通过右键单击该项目节点，然后转至“属性”>“运行配置”进行设置。
* *浏览器显示一个弹出式窗口，要求您打开文件，就像 PHP 引擎无法识别一样。* ``php5-common`` 软件包出现问题。请用 ``php5`` 和 ``phpmyadmin`` 替换此软件包。要替换 ``php5-common`` ，请运行下面的两个命令：
-[source,java]
+[source,bash]
----
apt-get --purge remove php5-commonapt-get install php5 phpmyadmin
@@ -127,7 +125,7 @@ apt-get --purge remove php5-commonapt-get install php5 phpmyadmin
文档根目录是 Apache HTTP 服务器存放用于在浏览器中显示的文件的目录。文档根目录是在定义虚拟主机的文件中指定的。默认虚拟主机配置文件为
-[source,java]
+[source,bash]
----
/etc/apache2/sites-available/default
@@ -136,7 +134,7 @@ apt-get --purge remove php5-commonapt-get install php5 phpmyadmin
其中指定的文档根目录为
-[source,java]
+[source,bash]
----
/var/www/
@@ -162,57 +160,69 @@ apt-get --purge remove php5-commonapt-get install php5 phpmyadmin
启动终端，请选择“应用程序”>“附件”>“终端”。此时将打开“终端”窗口。
2. 要将默认虚拟主机的配置文件复制到新文件 ( ``mysite`` )，请在命令提示符下键入以下命令：
-[source,java]
+[source,bash]
----
sudo cp /etc/apache2/sites-available/default /etc/apache2/sites-available/mysite
----
-3. 运行 ``
+
+[start=3]
+. 运行 ``
gedit`` 应用程序并在其中编辑新配置文件 ( ``mysite`` )：
-[source,java]
+[source,bash]
----
gksudo gedit /etc/apache2/sites-available/mysite
----
如果系统询问，请输入操作系统安装过程中为超级用户指定的口令。
-4. 更改文档根目录以指向新位置：
-[source,java]
+[start=4]
+. 更改文档根目录以指向新位置：
+
+[source,bash]
----
/home/<user>/public_html/
----
-5. 更改目录指令，将
-[source,java]
+[start=5]
+. 更改目录指令，将
+
+[source,bash]
----
<Directory /var/www/>
----
替换为
-[source,java]
+[source,bash]
----
<Directory /home/user/public_html/>
----
+
image::images/ubuntu-change-directory-root.png[]
-6. 保存文件 ``mysite``
+
+
+[start=6]
+. 保存文件 ``mysite``
=== 激活新虚拟主机
1. 要取消激活默认主机并激活新主机，<<launchTerminal,请启动终端>>并在“终端”窗口运行以下两个实用程序：
-[source,java]
+[source,bash]
----
sudo a2dissite default && sudo a2ensite mysite
----
-2. 重新启动 Apache HTTP 服务器：
-[source,java]
+[start=2]
+. 重新启动 Apache HTTP 服务器：
+
+[source,bash]
----
sudo /etc/init.d/apache2 reload
@@ -225,22 +235,23 @@ sudo /etc/init.d/apache2 reload
1. 要连接到 MySQL 服务器，<<launchTerminal,请启动终端>>，然后在“终端”窗口中输入以下命令：
-[source,java]
+[source,bash]
----
mysql -u root -p
----
此时将显示 MySQL 命令提示符。
-2. 在命令提示符下输入以下命令并按 Enter 键：
-[source,java]
-----
+[start=2]
+. 在命令提示符下输入以下命令并按 Enter 键：
+[source,sql]
+----
SET PASSWORD FOR 'root'@'localhost' = PASSWORD('<yourpassword>');
----
如果命令执行成功，则会显示以下消息：
-[source,java]
+[source,bash]
----
Query OK, 0 rows affected (0.00 sec)
@@ -268,16 +279,26 @@ Query OK, 0 rows affected (0.00 sec)
* php5-dev
* php-pear
对于每一项，从上下文菜单中选择“Mark for installation”。
-4. 打开“Mark additional required changes”对话框打开，其中具有相关包的列表，这些包也应该进行安装，以使软件能够正常工作。单击“Mark”。
-5. 系统将返回到“Synaptic Package Manager”面板，其中所选的软件包已标记为要安装。
-6. 选择工具栏上的“Apply”。此时将打开“Apply the following changes”概要面板，其中具有选择安装的包列表。单击“Apply”。
-7. 成功完成下载和安装之后，“Changes applied”面板将会打开。单击 "Close"（关闭）。
-*注：*您也可以通过在“终端”窗口中运行以下命令来安装这些模块： ``aptitude install php5-dev php-pear``
+[start=4]
+. 打开“Mark additional required changes”对话框打开，其中具有相关包的列表，这些包也应该进行安装，以使软件能够正常工作。单击“Mark”。
+
+[start=5]
+. 系统将返回到“Synaptic Package Manager”面板，其中所选的软件包已标记为要安装。
+
+[start=6]
+. 选择工具栏上的“Apply”。此时将打开“Apply the following changes”概要面板，其中具有选择安装的包列表。单击“Apply”。
+
+[start=7]
+. 成功完成下载和安装之后，“Changes applied”面板将会打开。单击 "Close"（关闭）。
-8. 现在，您可以下载并安装 XDebug。在“终端”窗口中输入以下命令：
+NOTE: 您也可以通过在“终端”窗口中运行以下命令来安装这些模块： ``aptitude install php5-dev php-pear``
-[source,java]
+
+[start=8]
+. 现在，您可以下载并安装 XDebug。在“终端”窗口中输入以下命令：
+
+[source,bash]
----
sudo pecl install xdebug
@@ -290,16 +311,20 @@ sudo pecl install xdebug
1. 要启动 ``gedit`` 文本处理器，请先启动<<launchTerminal,终端>>，然后在命令提示符下键入以下命令：
-[source,java]
+[source,bash]
----
gksudo gedit
----
如果系统询问，请输入操作系统安装过程中为超级用户指定的口令。
-2. 打开文件 ``/etc/php5/apache2/php.ini`` 。
-3. 将以下行添加到此文件中：
-[source,java]
+[start=2]
+. 打开文件 ``/etc/php5/apache2/php.ini`` 。
+
+[start=3]
+. 将以下行添加到此文件中：
+
+[source,bash]
----
zend_extension=/usr/lib/php5/<DATE+lfs>/xdebug.so
diff --git a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows.asciidoc
index 3fe3ff7..7baa9d2 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows.asciidoc
@@ -88,9 +88,9 @@ NOTE: Starting with XAMPP 1.7.2, XAMPP comes with PHP 5.3, not PHP 5.2.x. NetBea
On Microsoft Vista, the User Access Control feature blocks the PHP installer from updating the Apache httpd configuration. Disable UAC while you are installing XAMPP. See link:http://support.microsoft.com/kb/922708[+Microsoft support+] for more information.
[start=3]
-3. You are given the option to install the Apache server and the MySQL database server as services. If you install the Apache Server and MySQL as services, you will not have to start them manually through the XAMP Control Panel. Note that you have the option to install or uninstall these services in the <<xamppConstolPanel,XAMPP Control Panel>>.
-4. If you are using the self-extracting archive, after the archive is extracted, run the file ``setup-xampp.bat`` to configure the components of the package. (The XAMPP installer runs this file automatically.)
-5. After configuration, open the XAMP Control Panel. (You can open it manually by running the file ``XAMPP_HOME/xampp-control.exe`` or from the Xampp Control Panel icon that is automatically placed on your desktop.) When you open the XAMPP Control Panel, note that the modules that are installed as services are already running.
+. You are given the option to install the Apache server and the MySQL database server as services. If you install the Apache Server and MySQL as services, you will not have to start them manually through the XAMP Control Panel. Note that you have the option to install or uninstall these services in the <<xamppConstolPanel,XAMPP Control Panel>>.
+. If you are using the self-extracting archive, after the archive is extracted, run the file ``setup-xampp.bat`` to configure the components of the package. (The XAMPP installer runs this file automatically.)
+. After configuration, open the XAMP Control Panel. (You can open it manually by running the file ``XAMPP_HOME/xampp-control.exe`` or from the Xampp Control Panel icon that is automatically placed on your desktop.) When you open the XAMPP Control Panel, note that the modules that are installed as services are already running.
WARNING: On Windows Vista sometimes ``xampp-control.exe`` will not run. You can run ``xampp-start.exe`` instead.
@@ -99,7 +99,7 @@ WARNING: The ``winmysqladmin.exe file`` , which is launched by the Admin button
image::images/xampp-control-panel.png[]
[start=6]
-6. The Svc checkboxes indicate that a module is installed as a Windows service and will start automatically on system startup. You can install or uninstall Windows services by selecting or unselecting the Svc checkbox. Uninstalling a Windows service does not uninstall the module, but it does require you to start the module manually. The XAMPP control panel includes buttons for stopping and starting modules and opening their administration consoles.
+. The Svc checkboxes indicate that a module is installed as a Windows service and will start automatically on system startup. You can install or uninstall Windows services by selecting or unselecting the Svc checkbox. Uninstalling a Windows service does not uninstall the module, but it does require you to start the module manually. The XAMPP control panel includes buttons for stopping and starting modules and opening their administration consoles.
==== Checking XAMPP Installation
@@ -107,7 +107,8 @@ image::images/xampp-control-panel.png[]
image::images/xampp-welcome-page.png[]
-2. To ensure that the Apache and MySQL servers have been installed as system services, restart your operating system, run the browser, and enter the ``http://localhost`` URL again. The XAMPP welcome page opens. Note that the XAMPP welcome page includes a menu in the left margin through which you can check the status of XAMPP components and run ``phpinfo()`` , among other useful features. ``phpinfo()`` returns a screen with configuration information about your XAMPP components.
+[start=2]
+. To ensure that the Apache and MySQL servers have been installed as system services, restart your operating system, run the browser, and enter the ``http://localhost`` URL again. The XAMPP welcome page opens. Note that the XAMPP welcome page includes a menu in the left margin through which you can check the status of XAMPP components and run ``phpinfo()`` , among other useful features. ``phpinfo()`` returns a screen with configuration information about your XAMPP components.
image::images/xampp-phpinfo.png[]
@@ -139,7 +140,7 @@ You must download XDebug, place the .dll file in your php extensions directory,
----
[start=4]
-4. To attach
+. To attach
XDebug to the PHP engine, uncomment the following lines in the ``php.ini`` files (directly beneath the [Zend] section, add them if not there). Some additional notes have been added.
[source,ini]
@@ -156,8 +157,8 @@ Set the ``xdebug.remote_enable`` property to 1, not "true" or any other value.
NOTE: Make sure the paths you specify match the location of the corresponding files as determined during your installation.
[start=5]
-5. Save ``php.ini`` .
-6. Run the <<xamppConstolPanel,XAMPP Control Panel Application>> and restart the Apache server.
+. Save ``php.ini`` .
+. Run the <<xamppConstolPanel,XAMPP Control Panel Application>> and restart the Apache server.
See link:http://wiki.netbeans.org/HowToConfigureXDebug[+our wiki+] and the link:http://www.xdebug.org/docs/install[+XDebug documentation+] for more information on how to configure XDebug.
[[xdebug-xampp-172]]
@@ -186,8 +187,8 @@ See link:http://wiki.netbeans.org/HowToConfigureXDebug[+our wiki+] and the link:
On Microsoft Vista, do not install the Apache Server to the default location, which is in Program Files. All files in Program Files are write-protected.
[start=3]
-3. When the installation is completed, restart the Apache server.
-4. To check that the installation is successful, run the browser and enter the following URL:
+. When the installation is completed, restart the Apache server.
+. To check that the installation is successful, run the browser and enter the following URL:
[source,ini]
----
@@ -218,11 +219,11 @@ Find more information on installing and configuring the server link:http://httpd
NOTE: If there is no installer available for the version of PHP you want to install, you have to install it manually from the .zip file. See link:http://php.net/manual/en/install.windows.manual.php[+Manual Instruction Steps+] in the php.net documentation.
[start=2]
-2. When the download is complete, run the ``.msi`` installation file. The installation wizard starts.
-3. On the Apache Configuration Directory panel, specify the directory where the ``httpd.conf`` file is located, the default setting is ``C:\Program Files\Apache Software Foundation\Apache<version>\conf\`` . The PHP processing will be enabled automatically.
-4. If you want to use the MySQL database server, choose the Complete installation option or select the MySQL and MySQLi items in the Extensions list.
-5. After the installation is completed, restart the Apache server.
-6. To check that the PHP engine has been installed successfully and PHP processing has been enabled in the Apache configuration:
+. When the download is complete, run the ``.msi`` installation file. The installation wizard starts.
+. On the Apache Configuration Directory panel, specify the directory where the ``httpd.conf`` file is located, the default setting is ``C:\Program Files\Apache Software Foundation\Apache<version>\conf\`` . The PHP processing will be enabled automatically.
+. If you want to use the MySQL database server, choose the Complete installation option or select the MySQL and MySQLi items in the Extensions list.
+. After the installation is completed, restart the Apache server.
+. To check that the PHP engine has been installed successfully and PHP processing has been enabled in the Apache configuration:
* Open Notepad or another text editor. Create a file and type the following text:
[source,php]
@@ -252,8 +253,8 @@ If the page does not open:
LoadModule php5_module "c:/php/sapi/php5apache2_2.dll"
----
[start=3]
-3. If the lines are missing, add them, save ``httpd.conf`` , and restart Apache.
-4. Refresh the http://localhost:<port>/test.php page.
+. If the lines are missing, add them, save ``httpd.conf`` , and restart Apache.
+. Refresh the http://localhost:<port>/test.php page.
==== MySQL Database Server
@@ -315,7 +316,7 @@ Click link:http://www.xdebug.org/docs/install[+here+] for more information on ho
NOTE: Make sure the paths you specify match the names and locations of the corresponding files as determined during your installation.
[start=3]
-3. To be sure that previously installed PHP engine supports using the MySQL database server:
+. To be sure that previously installed PHP engine supports using the MySQL database server:
1. Click Start > Control Panel.
2. On the Control Panel, choose Add or Remove Programs.
diff --git a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows_ja.asciidoc
index 2a5f1a6..9da1a3c 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows_ja.asciidoc
@@ -32,9 +32,6 @@
このチュートリアルでは、Windowsオペレーティング・システムでPHP開発環境を構成する2つの方法を示します。1つ目の最も便利な方法は、AMP (*A*pache、*M*ySQL、*P*HP)パッケージをインストールして構成することです。このチュートリアルでは、XAMPPパッケージをインストールする方法を示します。2つ目の方法は、各コンポーネントを個別にインストールして構成することです。
-image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、NetBeans IDE 7.2、7.3、7.4および8.0に適用されます"]
-
-
*このチュートリアルに従うには、次のソフトウェアとリソースが必要です。*
|===
@@ -67,7 +64,7 @@ PHPプロジェクトを作成、実行、およびデバッグするには、
* PHPエンジン。サポートされているバージョンは、PHP5です。link:http://www.php.net/downloads.php[+ここ+]からダウンロードできます。
* PHPデバッガ。PHP向けのNetBeans IDEではlink:http://www.xdebug.org[+XDebug+]を使用できますが、デバッガの使用はオプションです。PHP5と互換性があるため、推奨バージョンはXDebug 2.0以降です。
* データベース・サーバー。様々なデータベース・サーバーを使用できますが、最もポピュラなサーバーはMySQLサーバーです。link:http://dev.mysql.com/downloads/mysql/5.1.html[+ここ+]からダウンロードできます。
-*注意:* 製品の推奨バージョンはMySQL Server 5.0です。提供されているドキュメントでは、このバージョンでの操作を説明します。
+NOTE: 製品の推奨バージョンはMySQL Server 5.0です。提供されているドキュメントでは、このバージョンでの操作を説明します。
インストールした後、すべてのソフトウェア・コンポーネントが互いに適切に機能する環境を設定する必要があります。
@@ -85,30 +82,44 @@ PHPエンジン、Apache HTTP Server、およびMySQLデータベース・サー
*警告:* XAMPP 1.7.0は使用しないでください。このバージョンは、XDebugに重大な問題があります。それらの問題が修正されているバージョン1.7.1以降を使用してください。
-*注意: *XAMPP 1.7.2以降では、XAMPPにはPHP 5.2.xではなくPHP 5.3が付属しています。PHP向けのNetBeans IDEバージョン6.7.xは、PHP 5.3の新機能をサポートしていません。PHP向けのNetBeans IDE 6.8は、現在、PHP 5.3を完全にサポートする開発ビルドとして使用できます。また、PHP 5.2.xとPHP 5.3では、XDebugのインストールも異なります。
+NOTE: XAMPP 1.7.2以降では、XAMPPにはPHP 5.2.xではなくPHP 5.3が付属しています。PHP向けのNetBeans IDEバージョン6.7.xは、PHP 5.3の新機能をサポートしていません。PHP向けのNetBeans IDE 6.8は、現在、PHP 5.3を完全にサポートする開発ビルドとして使用できます。また、PHP 5.2.xとPHP 5.3では、XDebugのインストールも異なります。
1. link:http://www.apachefriends.org/en/xampp-windows.html[+XAMPP+]インストーラ・パッケージをダウンロードします。(XAMPP LiteにはXDebugは含まれません。)
2. ダウンロードが完了したら、 ``.exe`` ファイルを実行します。
Microsoft Vistaの場合、ユーザー・アクセス制御機能により、PHPインストーラはApache httpdの構成を更新できません。XAMPPをインストールしている間は、UACを無効にします。詳細は、link:http://support.microsoft.com/kb/922708[+Microsoftのサポート+]を参照してください。
-3. ApacheサーバーとMySQLデータベース・サーバーをサービスとしてインストールするオプションがあります。ApacheサーバーとMySQLをサービスとしてインストールすると、これらをXAMPPコントロール・パネルから手動で起動する必要がありません。サービスは、<<xamppConstolPanel,XAMPPコントロール・パネル>>でインストールまたはアンインストールできます。
-4. 自己抽出型アーカイブを使用する場合は、アーカイブの抽出後に ``setup-xampp.bat`` ファイルを実行して、パッケージのコンポーネントを構成します。(XAMPPのインストーラではこのファイルが自動的に実行されます。)
-5. 構成が完了したら、XAMPPコントロール・パネルを開きます。(これを開くには、 ``XAMPP_HOME/xampp-control.exe`` ファイルを手動で実行するか、デスクトップに自動的に配置されるXAMPPコントロール・パネルのアイコンを使用します。)XAMPPコントロール・パネルを開くとき、サービスとしてインストールされたモジュールはすでに実行されています。
+
+[start=3.]
+. ApacheサーバーとMySQLデータベース・サーバーをサービスとしてインストールするオプションがあります。ApacheサーバーとMySQLをサービスとしてインストールすると、これらをXAMPPコントロール・パネルから手動で起動する必要がありません。サービスは、<<xamppConstolPanel,XAMPPコントロール・パネル>>でインストールまたはアンインストールできます。
+
+[start=4.]
+. 自己抽出型アーカイブを使用する場合は、アーカイブの抽出後に ``setup-xampp.bat`` ファイルを実行して、パッケージのコンポーネントを構成します。(XAMPPのインストーラではこのファイルが自動的に実行されます。)
+
+[start=5.]
+. 構成が完了したら、XAMPPコントロール・パネルを開きます。(これを開くには、 ``XAMPP_HOME/xampp-control.exe`` ファイルを手動で実行するか、デスクトップに自動的に配置されるXAMPPコントロール・パネルのアイコンを使用します。)XAMPPコントロール・パネルを開くとき、サービスとしてインストールされたモジュールはすでに実行されています。
*警告:* Windows Vistaでは、 ``xampp-control.exe`` が実行されない場合があります。かわりに ``xampp-start.exe`` を実行できます。
*警告: *MySQLの「管理ツール」ボタンによって実行される ``winmysqladmin.exeファイル`` は動作しません。複数のエラー・メッセージがカスケード表示され、これらのメッセージを停止するには、 ``winmysqladmin`` プロセスを手動で終了します。 ``winmysqladmin.exe`` はコマンド行からも実行できません。link:http://bugs.xampp.org/view.php?id=71[+http://bugs.xampp.org/view.php?id=71+]を参照してください。
image::images/xampp-control-panel.png[]
-6. 「サービス」チェックボックスは、モジュールがWindowsのサービスとしてインストールされ、システムの起動時に自動的に起動することを示します。「サービス」チェックボックスを選択または選択解除することで、Windowsのサービスをインストールまたはアンインストールできます。Windowsのサービスをアンインストールしても、モジュールはアンインストールされませんが、モジュールを手動で起動する必要があります。XAMPPコントロール・パネルには、モジュールを停止または起動したり、その管理コンソールを開くためのボタンがあります。
+
+
+[start=6.]
+. 「サービス」チェックボックスは、モジュールがWindowsのサービスとしてインストールされ、システムの起動時に自動的に起動することを示します。「サービス」チェックボックスを選択または選択解除することで、Windowsのサービスをインストールまたはアンインストールできます。Windowsのサービスをアンインストールしても、モジュールはアンインストールされませんが、モジュールを手動で起動する必要があります。XAMPPコントロール・パネルには、モジュールを停止または起動したり、その管理コンソールを開くためのボタンがあります。
=== XAMPPのインストールの確認
1. ブラウザを起動し、URLに ``http://localhost`` と入力します。XAMPPの開始ページが開きます。
+
image::images/xampp-welcome-page.png[]
-2. ApacheおよびMySQLサーバーがシステム・サービスとしてインストールされていることを確認するには、オペレーティング・システムを再起動してブラウザを起動し、もう一度URLに ``http://localhost`` と入力します。XAMPPの開始ページが開きます。XAMPPの開始ページの左マージンにはメニューが表示されており、これらのメニューを使用して様々な便利機能の中から、XAMPPコンポーネントのステータスを確認したり、 ``phpinfo()`` を実行したりできます。 ``phpinfo()`` は、XAMPPコンポーネントの構成情報が表示された画面を返します。
+
+
+[start=2.]
+. ApacheおよびMySQLサーバーがシステム・サービスとしてインストールされていることを確認するには、オペレーティング・システムを再起動してブラウザを起動し、もう一度URLに ``http://localhost`` と入力します。XAMPPの開始ページが開きます。XAMPPの開始ページの左マージンにはメニューが表示されており、これらのメニューを使用して様々な便利機能の中から、XAMPPコンポーネントのステータスを確認したり、 ``phpinfo()`` を実行したりできます。 ``phpinfo()`` は、XAMPPコンポーネントの構成情報が表示された画面を返します。
+
image::images/xampp-phpinfo.png[]
@@ -128,7 +139,7 @@ XDebugをダウンロードして、.dllファイルをphpの拡張ディレク
2. XAMPPのアクティブな ``php.ini`` ファイルを検索して開きます。このファイルはデフォルトで ``XAMPP_HOME/apache/bin`` ディレクトリにあります。アクティブな ``php.ini`` ファイルを確認するには、 ``phpinfo()`` を実行し、「Loaded Configuration File」を検索します。
3. ZendオプティマイザはXDebugをブロックするため、Zendオプティマイザを無効にする必要があります。アクティブな ``php.ini`` ファイル内で次の行を検索し、削除するか、またはコメントとしてマークします(安全のためには、Zendに関連するすべてのプロパティを検索してコメントアウトします)。
-[source,java]
+[source,ini]
----
[Zend]
@@ -139,9 +150,11 @@ XDebugをダウンロードして、.dllファイルをphpの拡張ディレク
;zend_optimizer.license_path =
----
-4. XDebugをPHPエンジンにアタッチするには、 ``php.ini`` ファイルで次の行のコメントを解除します(これらの行は[Zend]セクションのすぐ下にあり、ない場合は追加します)。追加のコメントがいくつか追加されています。
-[source,java]
+[start=4.]
+. XDebugをPHPエンジンにアタッチするには、 ``php.ini`` ファイルで次の行のコメントを解除します(これらの行は[Zend]セクションのすぐ下にあり、ない場合は追加します)。追加のコメントがいくつか追加されています。
+
+[source,ini]
----
[XDebug]; Only Zend OR (!) XDebug
@@ -152,10 +165,14 @@ zend_extension_ts = "./php/ext/php_xdebug<-version-number>.dll"
``xdebug.remote_enable`` プロパティは1に設定し、trueやその他の値には設定しないでください。
-*注意:* 指定するパスは、インストール時に定義した対応するファイルの場所と一致していることを確認してください。
+NOTE: 指定するパスは、インストール時に定義した対応するファイルの場所と一致していることを確認してください。
-5. ``php.ini`` を保存します。
-6. <<xamppConstolPanel,XAMPPコントロール・パネル・アプリケーション>>を実行し、Apacheサーバーを再起動します。
+
+[start=5.]
+. ``php.ini`` を保存します。
+
+[start=6.]
+. <<xamppConstolPanel,XAMPPコントロール・パネル・アプリケーション>>を実行し、Apacheサーバーを再起動します。
XDebugの構成方法の詳細は、link:http://wiki.netbeans.org/HowToConfigureXDebug[+Wiki+]およびlink:http://www.xdebug.org/docs/install[+XDebugのドキュメント+]を参照してください。
@@ -186,15 +203,20 @@ XDebugの構成方法の詳細は、link:http://wiki.netbeans.org/HowToConfigure
Microsoft Vistaでは、Apacheサーバーをデフォルトの場所である「Program Files」にインストールしないでください。「Program Files」内のファイルはすべて書込み保護されます。
-3. インストールが完了したら、Apacheサーバーを再起動します。
-4. インストールが正常に終了したことを確認するには、ブラウザを起動し、次のURLを入力します。
-[source,java]
+[start=3.]
+. インストールが完了したら、Apacheサーバーを再起動します。
+
+[start=4.]
+. インストールが正常に終了したことを確認するには、ブラウザを起動し、次のURLを入力します。
+
+[source,ini]
----
http://localhost/
----
Apacheの開始のテスト・ページが開きます。
+
image::images/install-apache-it-works-port80.png[]
@@ -218,11 +240,21 @@ image::images/install-apache-it-works-port80.png[]
*重要: *インストールするPHPバージョンのインストーラがない場合は、.zipファイルから手動でインストールする必要があります。php.netドキュメントのlink:http://php.net/manual/en/install.windows.manual.php[+手動による手順+]を参照してください。
-2. ダウンロードが完了したら、 ``.msi`` インストール・ファイルを実行します。インストール・ウィザードが起動します。
-3. 「Apache Configuration Directory」パネルで、 ``httpd.conf`` があるディレクトリを指定します(デフォルトの設定は、 ``C:\Program Files\Apache Software Foundation\Apache<version>\conf\`` です)。PHP処理が自動的に有効になります。
-4. MySQLデータベース・サーバーを使用する場合は、「Complete」インストール・オプションを選択するか、「Extensions」リストでMySQLとMySQLiの項目を選択します。
-5. インストールが完了した後、Apacheサーバーを再起動します。
-6. PHPエンジンが正常にインストールされていること、およびApache構成でPHP処理が有効になっていることを確認するには:
+
+[start=2.]
+. ダウンロードが完了したら、 ``.msi`` インストール・ファイルを実行します。インストール・ウィザードが起動します。
+
+[start=3.]
+. 「Apache Configuration Directory」パネルで、 ``httpd.conf`` があるディレクトリを指定します(デフォルトの設定は、 ``C:\Program Files\Apache Software Foundation\Apache<version>\conf\`` です)。PHP処理が自動的に有効になります。
+
+[start=4.]
+. MySQLデータベース・サーバーを使用する場合は、「Complete」インストール・オプションを選択するか、「Extensions」リストでMySQLとMySQLiの項目を選択します。
+
+[start=5.]
+. インストールが完了した後、Apacheサーバーを再起動します。
+
+[start=6.]
+. PHPエンジンが正常にインストールされていること、およびApache構成でPHP処理が有効になっていることを確認するには:
* メモ帳または他のテキスト・エディタを開きます。ファイルを作成し、次のテキストを入力します。
[source,php]
@@ -234,6 +266,7 @@ image::images/install-apache-it-works-port80.png[]
----
* htdocsフォルダにファイルを`test.php`として保存します。デフォルト・パスは、 ``C:\Program Files\Apache Software Foundation\Apache<version>\htdocs\test.php`` です。
* ブラウザを起動し、URLに ``http://localhost:<port>/test.php`` と入力します。次のページが開きます。
+
image::images/install-php-test.png[]
@@ -244,14 +277,18 @@ image::images/install-php-test.png[]
1. Apacheサーバーを再起動します。
2. Apacheサーバーの構成ファイルのhttpd.confに次の行が含まれていることを確認します。
-[source,java]
+[source,ini]
----
AddType Application/x-httpd-php .php
LoadModule php5_module "c:/php/sapi/php5apache2_2.dll"
----
-3. 行が見つからない場合は行を追加し、 ``httpd.conf`` を保存してApacheを再起動します。
-4. http://localhost:<port>/test.phpのページをリフレッシュします。
+
+[start=3.]
+. 行が見つからない場合は行を追加し、 ``httpd.conf`` を保存してApacheを再起動します。
+
+[start=4.]
+. http://localhost:<port>/test.phpのページをリフレッシュします。
=== MySQLデータベース・サーバー
@@ -267,13 +304,17 @@ image::images/install-php-test.png[]
=== 環境の設定
-1. デフォルトの設定に従ってインストールを実行した場合、PHP処理は自動的に有効になります。
-2. XDebugをPHPエンジンにアタッチするには、 ``php.ini`` ファイルを検索して次の行を追加します。
+
+[start=1.]
+. デフォルトの設定に従ってインストールを実行した場合、PHP処理は自動的に有効になります。
+
+[start=2.]
+. XDebugをPHPエンジンにアタッチするには、 ``php.ini`` ファイルを検索して次の行を追加します。
*スレッド・セーフ*なPHP 5.2エンジンの場合:
-[source,java]
+[source,ini]
----
zend_extension_ts="<path to the php folder>/php_xdebug-<version-number>.dll"
@@ -283,7 +324,7 @@ xdebug.remote_enable=1
*スレッド・セーフでない* PHP 5.2エンジンの場合:
-[source,java]
+[source,ini]
----
zend_extension_nts="<path to the php folder>/php_xdebug-<version-number>.dll"
@@ -293,7 +334,7 @@ xdebug.remote_enable=1
*任意の*PHP 5.3エンジンの場合:
-[source,java]
+[source,ini]
----
zend_extension="<path to the php folder>/php_xdebug-<version-number>.dll"
@@ -303,7 +344,7 @@ xdebug.remote_enable=1
ユーザーによっては、次の行を追加する必要がある場合と、そうでない場合があります。
-[source,java]
+[source,ini]
----
xdebug.remote_host=127.0.0.1xdebug.remote_port=9000
@@ -312,9 +353,12 @@ xdebug.remote_host=127.0.0.1xdebug.remote_port=9000
XDebugの構成方法の詳細は、link:http://www.xdebug.org/docs/install[+ここ+]をクリックしてください。
-*注意:* 指定するパスは、インストール時に定義した対応するファイルの名前および場所と一致していることを確認してください。
+NOTE: 指定するパスは、インストール時に定義した対応するファイルの名前および場所と一致していることを確認してください。
+
+
+[start=3.]
+. 前にインストールしたPHPエンジンがMySQLデータベース・サーバーの使用をサポートしていることを確認するには:
-3. 前にインストールしたPHPエンジンがMySQLデータベース・サーバーの使用をサポートしていることを確認するには:
1. 「スタート」>「コントロール パネル」をクリックします。
2. 「コントロール パネル」で「プログラムの追加と削除」を選択します。
3. 「プログラムの追加と削除」パネルで、PHP <バージョン番号>領域を選択し、「変更」をクリックします。PHPセットアップ・ウィザードが起動します。「次」をクリックします。
diff --git a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows_pt_BR.asciidoc
index 992ae2a..8a7cdbb 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows_pt_BR.asciidoc
@@ -32,9 +32,6 @@
Este tutorial mostra duas formas de configurar o ambiente de desenvolvimento de PHP no sistema operacional Windows. A primeira e mais conveniente é instalar e configurar um pacote AMP (*A*pache, *M*ySQL, *P*HP). Este tutorial mostra como instalar o pacote XAMPP. A segunda maneira, é instalar e configurar cada componente separadamente.
-image::images/netbeans-stamp-80-74-73.png[title="O conteúdo desta página se aplica ao NetBeans IDE 7.2, 7.3, 7.4 e 8.0"]
-
-
*Para seguir este tutorial, são necessários os recursos e o software a seguir.*
|===
@@ -67,7 +64,7 @@ Para criar, executar e depurar os projetos PHP, você precisa do seguinte softwa
* O mecanismo PHP. A versão com suporte é o PHP5. Os downloads estão disponíveis link:http://www.php.net/downloads.php[+aqui+].
* O depurador do PHP. O NetBeans IDE para PHP permite que você utilize o link:http://www.xdebug.org[+XDebug+], mas a utilização de um depurador é opcional. A versão recomendada é XDebug 2.0 ou superior, pois é compatível com PHP5.
* Um servidor de banco de dados. Você pode utilizar vários servidores de bancos de dados, embora um dos mais populares seja o MySQL. Os downloads estão disponíveis link:http://dev.mysql.com/downloads/mysql/5.1.html[+aqui+].
-*Observação:* a versão recomendada do produto é MySQL Server 5.0. Os documentos fornecidos descrevem o trabalho com essa versão.
+NOTE: a versão recomendada do produto é MySQL Server 5.0. Os documentos fornecidos descrevem o trabalho com essa versão.
Depois da instalação, você precisa configurar o ambiente de forma que todos os componentes de software funcionem bem juntos.
@@ -85,30 +82,44 @@ A seção descreve como fazer download, instalar e configurar o pacote XAMPP.
*Advertência:* NÃO use XAMPP 1.7.0. Há problemas significativos com o XDebug nessa versão. Use a versão 1.7.1 ou superior, em que esses problemas foram corrigidos.
-*Observação: *a partir do XAMPP 1.7.2, o XAMPP vem com PHP 5.3, não PHP 5.2.x. O NetBeans IDE para PHP, versão 6.7.x, não oferece suporte às novas funções do PHP 5.3. O NetBeans IDE para PHP 6.8, atualmente disponível como construtor de desenvolvimento, oferece suporte total ao PHP 5.3. Observe também que a instalação do Xdebug difere entre o PHP 5.2.x e o PHP 5.3.
+NOTE: a partir do XAMPP 1.7.2, o XAMPP vem com PHP 5.3, não PHP 5.2.x. O NetBeans IDE para PHP, versão 6.7.x, não oferece suporte às novas funções do PHP 5.3. O NetBeans IDE para PHP 6.8, atualmente disponível como construtor de desenvolvimento, oferece suporte total ao PHP 5.3. Observe também que a instalação do Xdebug difere entre o PHP 5.2.x e o PHP 5.3.
1. faça download do pacote de instalação do link:http://www.apachefriends.org/en/xampp-windows.html[+XAMPP+]. (O XAMPP Lite não inclui o XDebug.)
2. Quando o download tiver sido concluído, execute o arquivo `` .exe `` .
No Microsoft Vista, a funcionalidade Controle de Acesso do Usuário impede que o instalador do PHP atualize a configuração do httpd Apache. Desative o UAC ao instalar o XAMPP. Consulte o link:http://support.microsoft.com/kb/922708[+Suporte da Microsoft+] para obter mais informações.
-3. Você tem a opção de instalar o servidor Apache e o servidor de banco de dados MySQL como serviços. Se instalar o Servidor Apache e o MySQL como serviços, não terá que iniciá-los manualmente pelo Painel de Controle do XAMPP. Observe que você tem a opção de instalar ou desinstalar esses serviços no <<xamppConstolPanel,Painel de Controle do XAMPP>>.
-4. Se estiver utilizando o arquivo compactado autoextraível, depois de ele ter sido extraído, execute o arquivo ``setup-xampp.bat`` para configurar os componentes do pacote. (O instalador do XAMPP executa automaticamente o arquivo).
-5. Após configurar, abra o Painel de Controle do XAMPP. (Você pode abri-lo manualmente executando o arquivo ``XAMPP_HOME/xampp-control.exe`` ou a partir do ícone Painel de Controle do Xampp, que é automaticamente colocado em sua área de trabalho.) Ao abrir o Painel de Controle do XAMPP, observe que os módulos instalados como serviços já estão em execução.
+
+[start=3.]
+. Você tem a opção de instalar o servidor Apache e o servidor de banco de dados MySQL como serviços. Se instalar o Servidor Apache e o MySQL como serviços, não terá que iniciá-los manualmente pelo Painel de Controle do XAMPP. Observe que você tem a opção de instalar ou desinstalar esses serviços no <<xamppConstolPanel,Painel de Controle do XAMPP>>.
+
+[start=4.]
+. Se estiver utilizando o arquivo compactado autoextraível, depois de ele ter sido extraído, execute o arquivo ``setup-xampp.bat`` para configurar os componentes do pacote. (O instalador do XAMPP executa automaticamente o arquivo).
+
+[start=5.]
+. Após configurar, abra o Painel de Controle do XAMPP. (Você pode abri-lo manualmente executando o arquivo ``XAMPP_HOME/xampp-control.exe`` ou a partir do ícone Painel de Controle do Xampp, que é automaticamente colocado em sua área de trabalho.) Ao abrir o Painel de Controle do XAMPP, observe que os módulos instalados como serviços já estão em execução.
*Advertência: *algumas vezes, no Windows Vista, o ``xampp-control.exe`` não será executado. No lugar dele, você pode executar o ``xampp-start.exe`` .
*Advertência: *o ``arquivo winmysqladmin.exe`` , que é iniciado pelo botão Admin para o MySQL, não funciona. Aparece uma sequência de mensagens de erro, que pode ser parada somente de forma manual, pelo encerramento do processo ``winmysqladmin`` . Você também não pode acionar o ``winmysqladmin.exe`` a partir da linha de comandos. Consulte link:http://bugs.xampp.org/view.php?id=71[+http://bugs.xampp.org/view.php?id=71+].
image::images/xampp-control-panel.png[]
-6. As caixas de seleção Svc indicam que um módulo está instalado como um serviço do Windows e será automaticamente iniciado na inicialização do sistema. Você pode instalar ou desinstalar os serviços do Windows marcando ou desmarcando a caixa de seleção Svc. A desinstalação de um serviço do Windows não desinstala o módulo, mas requer a inicialização manual do módulo. O painel de controle do XAMPP inclui botões para parar e iniciar módulos e para abrir seus consoles de administração.
+
+
+[start=6.]
+. As caixas de seleção Svc indicam que um módulo está instalado como um serviço do Windows e será automaticamente iniciado na inicialização do sistema. Você pode instalar ou desinstalar os serviços do Windows marcando ou desmarcando a caixa de seleção Svc. A desinstalação de um serviço do Windows não desinstala o módulo, mas requer a inicialização manual do módulo. O painel de controle do XAMPP inclui botões para parar e iniciar módulos e para abrir seus consoles de administração.
=== Verificando a Instalação do XAMPP
1. Execute o browser e digite o seguinte URL: ``http://localhost`` . A página de boas-vindas do XAMPP será aberta:
+
image::images/xampp-welcome-page.png[]
-2. Para garantir que os servidores Apache e MySQL tenham sido instalados como serviços do sistema, reinicie o sistema operacional, execute o browser e digite o URL ``http://localhost`` novamente. A página de boas-vindas do XAMPP será aberta. Observe se a página de boas-vindas do XAMPP inclui um menu na margem esquerda, por meio do qual você pode verificar o status dos componentes do XAMPP e executar o ``phpinfo()`` , entre outras funcionalidades úteis. O ``phpinfo()`` retornará uma [...]
+
+
+[start=2.]
+. Para garantir que os servidores Apache e MySQL tenham sido instalados como serviços do sistema, reinicie o sistema operacional, execute o browser e digite o URL ``http://localhost`` novamente. A página de boas-vindas do XAMPP será aberta. Observe se a página de boas-vindas do XAMPP inclui um menu na margem esquerda, por meio do qual você pode verificar o status dos componentes do XAMPP e executar o ``phpinfo()`` , entre outras funcionalidades úteis. O ``phpinfo()`` retornará uma t [...]
+
image::images/xampp-phpinfo.png[]
@@ -128,7 +139,7 @@ Muitos usuários têm tido dificuldades para fazer com que o XDebug funcione em
2. Localize e abra o arquivo ``php.ini`` ativo para seu XAMPP. Ele está localizado por default no diretório `` XAMPP_HOME/apache/bin`` . Confirme qual arquivo ``php.ini`` está ativo executando ``phpinfo()`` e procurando o Arquivo de Configuração Carregado.
3. Como o otimizador Zend bloqueia o XDebug, é necessário desativar o otimizador Zend. No arquivo ``php.ini `` ativo, localize as linhas a seguir e as delete ou as marque como comentários (Para estar seguro, procure e comente todas as propriedades relacionadas ao Zend):
-[source,java]
+[source,ini]
----
[Zend]
@@ -139,10 +150,12 @@ Muitos usuários têm tido dificuldades para fazer com que o XDebug funcione em
;zend_optimizer.license_path =
----
-4. Para anexar
+
+[start=4.]
+. Para anexar
XDebug ao mecanismo PHP, remova o comentário das linhas a seguir nos arquivos ``php.ini`` (diretamente abaixo da seção [Zend], adicione-os caso não estejam presentes). Algumas notas adicionais foram acrescentadas.
-[source,java]
+[source,ini]
----
[XDebug]; Only Zend OR (!) XDebug
@@ -153,10 +166,14 @@ zend_extension_ts = "./php/ext/php_xdebug<-version-number>.dll"
Defina a propriedade ``xdebug.remote_enable`` como 1, não "true" ou qualquer outro valor.
-*Observação:* certifique-se de que os caminhos especificados coincidam com o local dos arquivos correspondentes, conforme determinado durante a instalação.
+NOTE: certifique-se de que os caminhos especificados coincidam com o local dos arquivos correspondentes, conforme determinado durante a instalação.
+
+
+[start=5.]
+. Salve o ``php.ini`` .
-5. Salve o ``php.ini`` .
-6. Execute a <<xamppConstolPanel,Aplicação Painel de Controle do XAMPP>> e reinicie o servidor Apache.
+[start=6.]
+. Execute a <<xamppConstolPanel,Aplicação Painel de Controle do XAMPP>> e reinicie o servidor Apache.
Consulte link:http://wiki.netbeans.org/HowToConfigureXDebug[+nosso wiki+] e a link:http://www.xdebug.org/docs/install[+documentação do XDebug+] para obter mais informações sobre como configurar o XDebug.
@@ -187,15 +204,20 @@ Consulte link:http://wiki.netbeans.org/HowToConfigureXDebug[+nosso wiki+] e a li
No Microsoft Vista, não instale o Servidor Apache na localização default, que é Arquivos de Programas. Todos os arquivos em Arquivos de Programas estão protegidos contra gravação.
-3. Quando a instalação tiver sido concluída, reinicie o servidor Apache.
-4. Para verificar se a instalação foi bem-sucedida, execute o browser e insira o seguinte URL:
-[source,java]
+[start=3.]
+. Quando a instalação tiver sido concluída, reinicie o servidor Apache.
+
+[start=4.]
+. Para verificar se a instalação foi bem-sucedida, execute o browser e insira o seguinte URL:
+
+[source,ini]
----
http://localhost/
----
A página de teste de boas-vindas do Apache será aberta:
+
image::images/install-apache-it-works-port80.png[]
@@ -215,15 +237,27 @@ Encontre mais informações sobre como instalar e configurar o servidor link:htt
=== Mecanismo PHP
-1. Faça download do link:http://windows.php.net/download/[+instalador binário do Windows+] para a versão PHP5 de sua escolha.
+
+[start=1.]
+. Faça download do link:http://windows.php.net/download/[+instalador binário do Windows+] para a versão PHP5 de sua escolha.
*Importante: *se não houver um instalador disponível na versão do PHP que você deseja instalar, instale-o manualmente pelo arquivo .zip. Consulte link:http://php.net/manual/en/install.windows.manual.php[+Etapas de Instrução Manual+] na documentação do php.net.
-2. Quando o download estiver concluído, execute o arquivo de instalação ``.msi`` . O assistente de instalação é iniciado.
-3. No painel Diretório de Configuração do Apache, especifique o diretório onde o arquivo ``httpd.conf`` está localizado, a definição default é ``C:\Arquivos de Programas\Apache Software Foundation\Apache<versão>\conf\`` . O processamento do PHP será ativado automaticamente.
-4. Se você desejar utilizar o servidor de banco de dados MySQL, escolha a opção de instalação Completa ou selecione os itens MySQL e MySQLi na lista Extensões.
-5. Depois que a instalação tiver sido concluída, reinicie o servidor Apache.
-6. Para verificar se o mecanismo PHP foi instalado com êxito e o processamento do PHP foi ativado na configuração do Apache:
+
+[start=2.]
+. Quando o download estiver concluído, execute o arquivo de instalação ``.msi`` . O assistente de instalação é iniciado.
+
+[start=3.]
+. No painel Diretório de Configuração do Apache, especifique o diretório onde o arquivo ``httpd.conf`` está localizado, a definição default é ``C:\Arquivos de Programas\Apache Software Foundation\Apache<versão>\conf\`` . O processamento do PHP será ativado automaticamente.
+
+[start=4.]
+. Se você desejar utilizar o servidor de banco de dados MySQL, escolha a opção de instalação Completa ou selecione os itens MySQL e MySQLi na lista Extensões.
+
+[start=5.]
+. Depois que a instalação tiver sido concluída, reinicie o servidor Apache.
+
+[start=6.]
+. Para verificar se o mecanismo PHP foi instalado com êxito e o processamento do PHP foi ativado na configuração do Apache:
* Abra o Bloco de Notas ou outro editor de texto. Crie um arquivo e digite o texto a seguir:
[source,php]
@@ -235,6 +269,7 @@ Encontre mais informações sobre como instalar e configurar o servidor link:htt
----
* Salve o arquivo na pasta htdocs como `test.php`. O caminho padrão é ``C:\Program Files\Apache Software Foundation\Apache<version>\htdocs\test.php``
* Execute o browser e digite o seguinte URL: ``http://localhost:<porta>/test.php`` . A página a seguir será aberta:
+
image::images/install-php-test.png[]
@@ -245,14 +280,18 @@ Se a página não abrir:
1. Reinicie o servidor Apache.
2. Verifique se o arquivo de configuração do servidor Apache httpd.conf contém as seguintes linhas:
-[source,java]
+[source,ini]
----
AddType Application/x-httpd-php .php
LoadModule php5_module "c:/php/sapi/php5apache2_2.dll"
----
-3. Se as linhas estiverem ausentes, adicione-as, salve o ``httpd.conf`` e reinicie o Apache.
-4. Atualize a página http://localhost:<port>/test.php.
+
+[start=3.]
+. Se as linhas estiverem ausentes, adicione-as, salve o ``httpd.conf`` e reinicie o Apache.
+
+[start=4.]
+. Atualize a página http://localhost:<port>/test.php.
=== Servidor de Banco de Dados MySQL
@@ -275,7 +314,7 @@ Encontre informações detalhadas em link:../ide/install-and-configure-mysql-ser
Para um mecanismo PHP 5.2 *seguro para thread*:
-[source,java]
+[source,ini]
----
zend_extension_ts="<path to the php folder>/php_xdebug-<version-number>.dll"
@@ -285,7 +324,7 @@ xdebug.remote_enable=1
Para um mecanismo PHP 5.2 *não seguro para thread*:
-[source,java]
+[source,ini]
----
zend_extension_nts="<path to the php folder>/php_xdebug-<version-number>.dll"
@@ -295,7 +334,7 @@ xdebug.remote_enable=1
Para *qualquer* mecanismo PHP 5.3:
-[source,java]
+[source,ini]
----
zend_extension="<path to the php folder>/php_xdebug-<version-number>.dll"
@@ -305,7 +344,7 @@ xdebug.remote_enable=1
Alguns usuários observam também que podem precisar incluir as seguintes linhas, embora outros usuários não precisem:
-[source,java]
+[source,ini]
----
xdebug.remote_host=127.0.0.1xdebug.remote_port=9000
@@ -314,9 +353,12 @@ xdebug.remote_host=127.0.0.1xdebug.remote_port=9000
Clique link:http://www.xdebug.org/docs/install[+aqui+] para obter mais informações sobre como configurar o XDebug.
-*Observação:* certifique-se de que os caminhos especificados coincidam com os nomes e os locais dos arquivos correspondentes, conforme determinado durante a instalação.
+NOTE: certifique-se de que os caminhos especificados coincidam com os nomes e os locais dos arquivos correspondentes, conforme determinado durante a instalação.
+
+
+[start=3.]
+. Para ter certeza de que o mecanismo PHP instalado anteriormente suporte a utilização do servidor de banco de dados MySQL:
-3. Para ter certeza de que o mecanismo PHP instalado anteriormente suporte a utilização do servidor de banco de dados MySQL:
1. Clique em Iniciar > Painel de Controle.
2. No Painel de Controle, selecione Adicionar ou Remover Programas.
3. No painel Adicionar ou Remover Programas, selecione a área PHP <número de versão> área e clique em Alterar. O Assistente Configuração do PHP será Iniciado. Clique em Próximo.
diff --git a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows_ru.asciidoc
index 8bd04c1..4269702 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows_ru.asciidoc
@@ -32,9 +32,6 @@
В данном учебном курсе рассматриваются два способа настройки среды разработки PHP в операционной системе Windows. Первый и наиболее удобный способ состоит в установке и настройке пакета AMP (*A*pache, *М*ySQL, *P*HP). В данном учебном курсе приводится процедура установки пакета XAMPP. Второй способ состоит в установке и настройке каждого компонента по отдельности.
-image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой страницы применимо к IDE NetBeans 7.2, 7.3, 7.4 и 8.0"]
-
-
*Для работы с этим учебным курсом требуется следующее программное обеспечение и ресурсы.*
|===
@@ -67,7 +64,7 @@ image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой
* Механизм PHP. Поддерживается версия PHP5. Загрузку можно осуществить link:http://www.php.net/downloads.php[+отсюда+].
* Отладчик PHP. IDE NetBeans для PHP позволяет использовать link:http://www.xdebug.org[+XDebug+], но использование отладчика не является обзательным. Из соображений совместимости с PHP5 рекомендуется использовать версию XDebug 2.0 или выше.
* Сервер базы данных. Существует возможность использования различных серверов базы данных, однако самым популярным из них является сервер MySQL. Загрузку можно осуществить link:http://dev.mysql.com/downloads/mysql/5.1.html[+отсюда+].
-*Примечание.* Рекомендуемая версия продукта: MySQL Server 5.0. В предоставленных документах описывается работа с этой версией.
+NOTE: Рекомендуемая версия продукта: MySQL Server 5.0. В предоставленных документах описывается работа с этой версией.
По завершении установки необходимо выполнить настройку среды в целях обеспечения правильной совместной работы всех программных компонентов.
@@ -85,30 +82,44 @@ image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой
*Предупреждение!* НЕ используйте XAMPP 1.7.0. В этой версии имеются значительные проблемы с XDebug. Используйте версию 1.7.1 или выше, где эти неполадки устранены.
-*Примечание: * Начиная с XAMPP 1.7.2, XAMPP поставляется с PHP 5.3а не с PHP 5.2.x. IDE NetBeans для PHP версии 6.7.x не поддерживает новые функции PHP 5.3. IDE NetBeans для PHP 6.8, которая в настоящее время доступна как сборка разработки, полностью поддерживает PHP 5.3. Также обратите внимание, что установка Xdebug различается для PHP 5.2.x и PHP 5.3.
+NOTE: Начиная с XAMPP 1.7.2, XAMPP поставляется с PHP 5.3а не с PHP 5.2.x. IDE NetBeans для PHP версии 6.7.x не поддерживает новые функции PHP 5.3. IDE NetBeans для PHP 6.8, которая в настоящее время доступна как сборка разработки, полностью поддерживает PHP 5.3. Также обратите внимание, что установка Xdebug различается для PHP 5.2.x и PHP 5.3.
1. Загрузите пакет программы установки link:http://www.apachefriends.org/en/xampp-windows.html[+XAMPP +]. В состав XAMPP Lite не входит XDebug.
2. По завершении загрузки запустите файл ``EXE`` .
В Microsoft Vista функция контроля учетных записей пользователей (UAC) блокирует обновление установщиком PHP настройки службы httpd Apache. На время установки XAMPP следует отключить UAC. Для получения дополнительных сведений обратитесь к разделу link:http://support.microsoft.com/kb/922708[+Поддержка Майкрософт+].
-3. Можно установить сервер Apache и сервер базы данных MySQL как веб-службы. Если Apache Server и MySQL установлены как службы, то нет необходимости запускать их вручную с помощью "XAMP Control Panel". Следует учитывать, что установить и удалить эти службы можно с помощью <<xamppConstolPanel,панели управления XAMPP>>.
-4. При использовании самораспаковывающегося архива после его распаковки запустите файл ``setup-xampp.bat`` для настройки компонентов пакета. Программа установки XAMPP запускает этот файл автоматически.
-5. После настройки откройте панель управления XAMP. Эту панель можно открыть посредством запуска файла ``XAMPP_HOME/xampp-control.exe`` или с помощью значка панель управления XAMPP, автоматически размещаемого на рабочем столе. При открытии панели управления XAMPP следует учитывать, что модули, установленные как службы, уже выполняются.
+
+[start=3]
+. Можно установить сервер Apache и сервер базы данных MySQL как веб-службы. Если Apache Server и MySQL установлены как службы, то нет необходимости запускать их вручную с помощью "XAMP Control Panel". Следует учитывать, что установить и удалить эти службы можно с помощью <<xamppConstolPanel,панели управления XAMPP>>.
+
+[start=4]
+. При использовании самораспаковывающегося архива после его распаковки запустите файл ``setup-xampp.bat`` для настройки компонентов пакета. Программа установки XAMPP запускает этот файл автоматически.
+
+[start=5]
+. После настройки откройте панель управления XAMP. Эту панель можно открыть посредством запуска файла ``XAMPP_HOME/xampp-control.exe`` или с помощью значка панель управления XAMPP, автоматически размещаемого на рабочем столе. При открытии панели управления XAMPP следует учитывать, что модули, установленные как службы, уже выполняются.
*Предупреждение. *Иногда в Windows Vista не удается запустить файл ``xampp-control.exe`` . В этом случае можно запустить ``xampp-start.exe`` .
*Предупреждение. *Файл ``winmysqladmin.exe`` , запускаемый кнопкой "Admin" для MySQL, не функционирует. Отображается последовательность сообщений об ошибках, которая может быть остановлена только путем завершения процесса ``winmysqladmin`` вручную. Файл ``winmysqladmin.exe`` также невозможно запустить из командной строки. Обратитесь к странице link:http://bugs.xampp.org/view.php?id=71[+http://bugs.xampp.org/view.php?id=71+].
image::images/xampp-control-panel.png[]
-6. Флажки "Svc" указывают на то, что модуль устанавливается как служба Windows и автоматически выполняется при запуске системы. Службы Windows устанавливаются и удаляются при установке и снятии флажка "Svc". При удалении службы Windows сам модуль не удаляется, однако необходимо запускать его вручную. Панель управления XAMPP включает в себя кнопки запуска и остановки модулей, а также открытия их консолей администратора.
+
+
+[start=6]
+. Флажки "Svc" указывают на то, что модуль устанавливается как служба Windows и автоматически выполняется при запуске системы. Службы Windows устанавливаются и удаляются при установке и снятии флажка "Svc". При удалении службы Windows сам модуль не удаляется, однако необходимо запускать его вручную. Панель управления XAMPP включает в себя кнопки запуска и остановки модулей, а также открытия их консолей администратора.
=== Проверка установки XAMPP
1. Запустите браузер и введите следующий URL-адрес: ``http://localhost`` . Откроется страница приветствия XAMPP:
+
image::images/xampp-welcome-page.png[]
-2. В целях обеспечения установки серверов Apache и MySQL в качестве служб системы перезапустите операционную систему, запустите браузер и повторно введите URL-адрес ``http://localhost`` . Откроется страница приветствия XAMPP. Обратите внимание на то, что в левом поле страницы приветствия XAMPP имеется меню, посредством которого можно проверить состояние компонентов XAMPP, запустить ``phpinfo()`` , а также воспользоваться другими важными функциями. При выполнении ``phpinfo()`` возвращ [...]
+
+
+[start=2]
+. В целях обеспечения установки серверов Apache и MySQL в качестве служб системы перезапустите операционную систему, запустите браузер и повторно введите URL-адрес ``http://localhost`` . Откроется страница приветствия XAMPP. Обратите внимание на то, что в левом поле страницы приветствия XAMPP имеется меню, посредством которого можно проверить состояние компонентов XAMPP, запустить ``phpinfo()`` , а также воспользоваться другими важными функциями. При выполнении ``phpinfo()`` возвраща [...]
+
image::images/xampp-phpinfo.png[]
@@ -128,7 +139,7 @@ image::images/xampp-phpinfo.png[]
2. Найдите и откройте активный файл ``php.ini`` для XAMPP. По умолчанию он находится в каталоге `` XAMPP_HOME/apache/bin`` . Подтвердите, какой файл ``php.ini`` является активным, с помощью ``phpinfo()`` и поиска загруженного файла конфигурации.
3. Поскольку оптимизатор Zend блокирует XDebug, оптимизатор требуется отключить. В активном файле ``php.ini `` найдите следующие строки и удалите или отметьте их как комментарии (для надежности выполните поиск и закомментируйте все свойства, связанные с Zend):
-[source,java]
+[source,ini]
----
[Zend]
@@ -139,10 +150,12 @@ image::images/xampp-phpinfo.png[]
;zend_optimizer.license_path =
----
-4. Для присоединения
+
+[start=4]
+. Для присоединения
XDebug к механизму PHP раскомментируйте следующие строки в файлах ``php.ini`` (добавьте эти строки непосредственно в разделе [Zend]), если они отсутствуют. Добавлены дополнительные примечания.
-[source,java]
+[source,ini]
----
[XDebug]; Only Zend OR (!) XDebug
@@ -153,10 +166,14 @@ zend_extension_ts = "./php/ext/php_xdebug<-version-number>.dll"
Установите свойство ``xdebug.remote_enable`` в значение 1, а не в значение "true" или другое значение.
-*Примечание.* Убедитесь в том, что указанные пути соответствуют расположению соответствующих файлов, как это определено при установке.
+NOTE: Убедитесь в том, что указанные пути соответствуют расположению соответствующих файлов, как это определено при установке.
-5. Сохраните файл ``php.ini`` .
-6. Запустите <<xamppConstolPanel,панель управления XAMPP>> и перезапустите сервер Apache.
+
+[start=5]
+. Сохраните файл ``php.ini`` .
+
+[start=6]
+. Запустите <<xamppConstolPanel,панель управления XAMPP>> и перезапустите сервер Apache.
Дополнительные сведения о настройке XDebug приведены на link:http://wiki.netbeans.org/HowToConfigureXDebug[+вики-странице+] и в link:http://www.xdebug.org/docs/install[+документации по XDebug+].
@@ -182,20 +199,29 @@ XAMPP 1.7.2 поставляется вместе с соответствующ
=== Сервер HTTP Apache
-1. Загрузите link:http://httpd.apache.org/download.cgi[+сервер HTTP Apache2+].
-2. Запустите установочный файл ``.msi`` . Запускается мастер установки. Следуйте указаниям.
+
+[start=1]
+. Загрузите link:http://httpd.apache.org/download.cgi[+сервер HTTP Apache2+].
+
+[start=2]
+. Запустите установочный файл ``.msi`` . Запускается мастер установки. Следуйте указаниям.
В Microsoft Vista не следует устанавливать Apache Server в местоположение по умолчанию, находящееся в папке "Program Files". Все файлы в папке "Program Files" защищены от записи.
-3. По завершении установки перезапустите сервер Apache.
-4. Для проверки успешности установки запустите браузер и введите следующий URL-адрес:
-[source,java]
+[start=3]
+. По завершении установки перезапустите сервер Apache.
+
+[start=4]
+. Для проверки успешности установки запустите браузер и введите следующий URL-адрес:
+
+[source,ini]
----
http://localhost/
----
Откроется страница приветствия Apache:
+
image::images/install-apache-it-works-port80.png[]
@@ -219,11 +245,21 @@ image::images/install-apache-it-works-port80.png[]
*Важно.*Если установщик для нужной версии PHP отсутствует, установите ее вручную из файла .zip. См. раздел link:http://php.net/manual/en/install.windows.manual.php[+Этапы ручной установки+] в документации php.net.
-2. По завершении загрузки запустите установочный файл ``.msi`` . Запускается мастер установки.
-3. На экране "Каталог конфигурации Apache" укажите каталог, в котором расположен файл ``httpd.conf`` (по умолчанию используется каталог ``C:\Program Files\Apache Software Foundation\Apache<version>\conf\`` ). Обработка кода PHP включается автоматически.
-4. При необходимости использования сервера базы данных MySQL выберите вариант "Полная установка" или выберите элементы MySQL и MySQLi в списке "Расширения".
-5. После завершения установки перезапустите сервер Apache.
-6. Для проверки успешности установки механизма PHP и включения обработки кода PHP в настройке Apache выполните следующие действия:
+
+[start=2]
+. По завершении загрузки запустите установочный файл ``.msi`` . Запускается мастер установки.
+
+[start=3]
+. На экране "Каталог конфигурации Apache" укажите каталог, в котором расположен файл ``httpd.conf`` (по умолчанию используется каталог ``C:\Program Files\Apache Software Foundation\Apache<version>\conf\`` ). Обработка кода PHP включается автоматически.
+
+[start=4]
+. При необходимости использования сервера базы данных MySQL выберите вариант "Полная установка" или выберите элементы MySQL и MySQLi в списке "Расширения".
+
+[start=5]
+. После завершения установки перезапустите сервер Apache.
+
+[start=6]
+. Для проверки успешности установки механизма PHP и включения обработки кода PHP в настройке Apache выполните следующие действия:
* Откройте блокнот или любой другой текстовый редактор. Создайте файл и введите следующий текст:
[source,php]
@@ -235,6 +271,7 @@ image::images/install-apache-it-works-port80.png[]
----
* Сохраните файл в папке htdocs с именем `test.php`. По умолчанию путь к файлу имеет вид ``C:\Program Files\Apache Software Foundation\Apache<version>\htdocs\test.php``
* Запустите браузер и введите следующий URL-адрес: ``http://localhost:<port>/test.php`` . Откроется следующая страница:
+
image::images/install-php-test.png[]
@@ -245,14 +282,18 @@ image::images/install-php-test.png[]
1. Перезапустите сервер Apache.
2. Убедитесь, что файл настройки сервера Apache httpd.conf содержит следующие строки:
-[source,java]
+[source,ini]
----
AddType Application/x-httpd-php .php
LoadModule php5_module "c:/php/sapi/php5apache2_2.dll"
----
-3. Если эти строки отсутствуют, добавьте их, сохраните ``httpd.conf`` и перезапустите сервер Apache.
-4. Обновите страницу http://localhost:<port>/test.php.
+
+[start=3]
+. Если эти строки отсутствуют, добавьте их, сохраните ``httpd.conf`` и перезапустите сервер Apache.
+
+[start=4]
+. Обновите страницу http://localhost:<port>/test.php.
=== Сервер базы данных MySQL
@@ -275,7 +316,7 @@ image::images/install-php-test.png[]
Для механизма PHP 5.2 *с ориентацией на многопотоковое исполнение*:
-[source,java]
+[source,ini]
----
zend_extension_ts="<path to the php folder>/php_xdebug-<version-number>.dll"
@@ -285,7 +326,7 @@ xdebug.remote_enable=1
Для механизма PHP 5.2 *без ориентации на многопотоковое исполнение*:
-[source,java]
+[source,ini]
----
zend_extension_nts="<path to the php folder>/php_xdebug-<version-number>.dll"
@@ -295,7 +336,7 @@ xdebug.remote_enable=1
Для *любого* механизма PHP 5.3:
-[source,java]
+[source,ini]
----
zend_extension="<path to the php folder>/php_xdebug-<version-number>.dll"
@@ -305,7 +346,7 @@ xdebug.remote_enable=1
Некоторые пользователи считают, что необходимо включить в код следующие строки, однако другие пользователи пропускают их:
-[source,java]
+[source,ini]
----
xdebug.remote_host=127.0.0.1xdebug.remote_port=9000
@@ -314,9 +355,12 @@ xdebug.remote_host=127.0.0.1xdebug.remote_port=9000
Дополнительные сведения о настройке отладчика XDebug приведена link:http://www.xdebug.org/docs/install[+здесь+].
-*Примечание.* Убедитесь в том, что указанные пути соответствуют именам и расположению соответствующих файлов, как это определено при установке.
+NOTE: Убедитесь в том, что указанные пути соответствуют именам и расположению соответствующих файлов, как это определено при установке.
+
+
+[start=3]
+. Для проверки того, что предварительно установленный механизм PHP поддерживает использование сервера базы данных MySQL выполните следующие действия:
-3. Для проверки того, что предварительно установленный механизм PHP поддерживает использование сервера базы данных MySQL выполните следующие действия:
1. Выберите команду "Пуск" > "Панель управления".
2. На экране "Панель управления" выберите параметр "Добавление или удаление программ".
3. На экране "Добавление или удаление программ" перейдите к области "PHP <номер_версии>" и нажмите кнопку "Изменить". Последует запуск мастера настройки PHP. Нажмите кнопку "Далее".
diff --git a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows_zh_CN.asciidoc
index 017c997..85839cd 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/configure-php-environment-windows_zh_CN.asciidoc
@@ -32,9 +32,6 @@
本教程介绍了在 Windows 操作系统上配置 PHP 开发环境的两种方法。第一种方法是安装和配置 AMP (*A*pache、*M*ySQL、*P*HP) 包，这种方法最为简便。本教程介绍了如何安装 XAMPP 包。第二种方法是单独安装和配置每个组件。
-image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 NetBeans IDE 7.2、7.3、7.4 和 8.0"]
-
-
*要学习本教程，您需要具备以下软件和资源。*
|===
@@ -67,7 +64,7 @@ image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 Net
* PHP 引擎。支持的版本是 PHP5。可以从link:http://www.php.net/downloads.php[+此处+]进行下载。
* PHP 调试器。用于 PHP 的 NetBeans IDE 使您能够使用 link:http://www.xdebug.org[+XDebug+]，但使用调试器是可选的。推荐版本为 XDebug 2.0 或更高版本，因为它与 PHP5 兼容。
* 数据库服务器。您可以使用多种数据库服务器，而最受欢迎的一种是 MySQL 服务器。可以从link:http://dev.mysql.com/downloads/mysql/5.1.html[+此处+]进行下载。
-*注：*该产品的推荐版本为 MySQL Server 5.0。提供的文档描述如何使用此版本。
+NOTE: 该产品的推荐版本为 MySQL Server 5.0。提供的文档描述如何使用此版本。
安装之后，需要设置环境，使所有软件组件可以彼此之间正常配合工作。
@@ -85,30 +82,44 @@ image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 Net
*警告：*不要使用 XAMPP 1.7.0。此版本中的 XDebug 出现重大问题。可以使用版本 1.7.1 或更高版本，其中已修复这些问题。
-*注：*从 XAMPP 1.7.2 开始，XAMPP 附带提供 PHP 5.3 而不是 PHP 5.2.x。适用于 PHP 的 NetBeans IDE 版本 6.7.x 不支持新的 PHP 5.3 功能。适用于 PHP 6.8 的 NetBeans IDE 目前提供开发版本，完全支持 PHP 5.3。另请注意，PHP 5.2.x 和 PHP 5.3 之间的 Xdebug 安装不同。
+NOTE: 从 XAMPP 1.7.2 开始，XAMPP 附带提供 PHP 5.3 而不是 PHP 5.2.x。适用于 PHP 的 NetBeans IDE 版本 6.7.x 不支持新的 PHP 5.3 功能。适用于 PHP 6.8 的 NetBeans IDE 目前提供开发版本，完全支持 PHP 5.3。另请注意，PHP 5.2.x 和 PHP 5.3 之间的 Xdebug 安装不同。
1. 下载 link:http://www.apachefriends.org/en/xampp-windows.html[+XAMPP+] 安装包。（XAMPP Lite 不包括 XDebug。）
2. 下载完成后，运行 ``.exe`` 文件。
在 Microsoft Vista 上，“用户访问控制”功能会阻止 PHP 安装程序更新 Apache httpd 配置。在安装 XAMPP 时请禁用 UAC。有关详细信息，请参见 link:http://support.microsoft.com/kb/922708[+Microsoft 支持+]。
-3. 您可以选择作为服务安装 Apache 服务器和 MySQL 数据库服务器。如果将 Apache 服务器和 MySQL 作为服务进行安装，则您将不必通过 XAMPP 控制面板来手动启动它们。请注意，您可以在 <<xamppConstolPanel,XAMPP 控制面板>>中选择安装或卸载这些服务。
-4. 如果您使用的是自解压档案文件，请在解压缩该档案文件之后，运行 ``setup-xampp.bat`` 文件以配置该包的组件。（XAMPP 安装程序会自动运行此文件。）
-5. 配置之后，打开 XAMPP 控制面板。（您可以通过运行 ``XAMPP_HOME/xampp-control.exe`` 文件或通过自动置于桌面上的 XAMPP 控制面板图标手动打开该控制面板。）在打开 XAMPP 控制面板时，请注意作为服务安装的模块是否已在运行。
+
+[start=3]
+. 您可以选择作为服务安装 Apache 服务器和 MySQL 数据库服务器。如果将 Apache 服务器和 MySQL 作为服务进行安装，则您将不必通过 XAMPP 控制面板来手动启动它们。请注意，您可以在 <<xamppConstolPanel,XAMPP 控制面板>>中选择安装或卸载这些服务。
+
+[start=4]
+. 如果您使用的是自解压档案文件，请在解压缩该档案文件之后，运行 ``setup-xampp.bat`` 文件以配置该包的组件。（XAMPP 安装程序会自动运行此文件。）
+
+[start=5]
+. 配置之后，打开 XAMPP 控制面板。（您可以通过运行 ``XAMPP_HOME/xampp-control.exe`` 文件或通过自动置于桌面上的 XAMPP 控制面板图标手动打开该控制面板。）在打开 XAMPP 控制面板时，请注意作为服务安装的模块是否已在运行。
*警告：*在 Windows Vista 上，有时 ``xampp-control.exe`` 不会运行。这时您可以运行 ``xampp-start.exe`` 。
*警告：*如果通过 MySQL 的“管理”按钮启动 ``winmysqladmin.exe`` 文件，则该文件将无法正常运行。出现层叠错误消息时，只能通过手动终止 ``winmysqladmin`` 进程来阻止这些消息。您也无法从命令行启动 ``winmysqladmin.exe`` 。请参见 link:http://bugs.xampp.org/view.php?id=71[+http://bugs.xampp.org/view.php?id=71+]。
image::images/xampp-control-panel.png[]
-6. "Svc" 复选框指示模块是作为 Windows 服务安装的，并且将在系统启动时自动启动。您可以通过选中或取消选中 "Svc" 复选框来安装或卸载 Windows 服务。卸载 Windows 服务不会卸载模块，但之后您需要手动启动该模块。XAMPP 控制面板包括用于停止和启动模块以及打开这些模块的管理控制台的按钮。
+
+
+[start=6]
+. "Svc" 复选框指示模块是作为 Windows 服务安装的，并且将在系统启动时自动启动。您可以通过选中或取消选中 "Svc" 复选框来安装或卸载 Windows 服务。卸载 Windows 服务不会卸载模块，但之后您需要手动启动该模块。XAMPP 控制面板包括用于停止和启动模块以及打开这些模块的管理控制台的按钮。
=== 检查 XAMPP 安装
1. 运行浏览器，然后输入以下 URL： ``http://localhost`` 。XAMPP 欢迎页面打开：
+
image::images/xampp-welcome-page.png[]
-2. 要确保 Apache 和 MySQL 服务器已作为系统服务安装，请重新启动您的操作系统，再运行浏览器，然后再次输入 ``http://localhost`` URL。XAMPP 欢迎页面打开。请注意，XAMPP 欢迎页面在左旁注中包含一个菜单，您可以通过此菜单检查 XAMPP 组件的状态，运行 ``phpinfo()`` ，以及实现其他有用的功能。 ``phpinfo()`` 会返回一个屏幕，其中显示关于 XAMPP 组件的配置信息。
+
+
+[start=2]
+. 要确保 Apache 和 MySQL 服务器已作为系统服务安装，请重新启动您的操作系统，再运行浏览器，然后再次输入 ``http://localhost`` URL。XAMPP 欢迎页面打开。请注意，XAMPP 欢迎页面在左旁注中包含一个菜单，您可以通过此菜单检查 XAMPP 组件的状态，运行 ``phpinfo()`` ，以及实现其他有用的功能。 ``phpinfo()`` 会返回一个屏幕，其中显示关于 XAMPP 组件的配置信息。
+
image::images/xampp-phpinfo.png[]
@@ -128,7 +139,7 @@ image::images/xampp-phpinfo.png[]
2. 找到 XAMPP 的活动 ``php.ini`` 文件并将其打开。默认情况下，此文件位于 ``XAMPP_HOME/apache/bin`` 目录中。通过运行 ``phpinfo()`` 并搜索 "Loaded Configuration File" 来确认活动的 ``php.ini`` 文件。
3. 由于 Zend 优化器会阻止 XDebug，因此您需要禁用 Zend 优化器。在活动的 ``php.ini`` 文件中找到以下行，然后将其删除或标记为注释（为了安全起见，请搜索与 Zend 相关的所有属性并将其注释掉）：
-[source,java]
+[source,ini]
----
[Zend]
@@ -139,10 +150,12 @@ image::images/xampp-phpinfo.png[]
;zend_optimizer.license_path =
----
-4. 要将
+
+[start=4]
+. 要将
XDebug 附加到 PHP 引擎，请在 ``php.ini`` 文件中取消对以下行（恰好位于 [Zend] 部分下面；如果没有，请添加它们）的注释。已另外添加一些注释。
-[source,java]
+[source,ini]
----
[XDebug]; Only Zend OR (!) XDebug
@@ -153,10 +166,14 @@ zend_extension_ts = "./php/ext/php_xdebug<-version-number>.dll"
将 ``xdebug.remote_enable`` 属性设置为 1，而不是 "true" 或任何其他值。
-*注：*请确保您指定的路径与安装过程中所确定的相应文件的位置匹配。
+NOTE: 请确保您指定的路径与安装过程中所确定的相应文件的位置匹配。
-5. 保存 ``php.ini`` 。
-6. 运行 <<xamppConstolPanel,XAMPP Control Panel Application（XAMPP 控制面板应用程序）>>并重新启动 Apache 服务器。
+
+[start=5]
+. 保存 ``php.ini`` 。
+
+[start=6]
+. 运行 <<xamppConstolPanel,XAMPP Control Panel Application（XAMPP 控制面板应用程序）>>并重新启动 Apache 服务器。
有关如何配置 XDebug 的详细信息，请参见link:http://wiki.netbeans.org/HowToConfigureXDebug[+我们的 wiki+] 和 link:http://www.xdebug.org/docs/install[+XDebug 文档+]。
@@ -187,15 +204,20 @@ XAMPP 1.7.2 捆绑了相应的 Xdebug .dll 文件。只需配置 ``php.ini``
在 Microsoft Vista 上，不要将 Apache 服务器安装到 Program Files 中的默认位置。Program Files 中的所有文件均具有写保护。
-3. 安装完成后，重新启动 Apache 服务器。
-4. 要检查安装是否成功，请运行浏览器，然后输入以下 URL：
-[source,java]
+[start=3]
+. 安装完成后，重新启动 Apache 服务器。
+
+[start=4]
+. 要检查安装是否成功，请运行浏览器，然后输入以下 URL：
+
+[source,ini]
----
http://localhost/
----
Apache 欢迎测试页面打开：
+
image::images/install-apache-it-works-port80.png[]
@@ -219,11 +241,21 @@ image::images/install-apache-it-works-port80.png[]
*重要信息：*如果没有安装程序适用于您要安装的 PHP 版本，则必须手动从 .zip 文件中安装它。请参见 php.net 文档中的link:http://php.net/manual/en/install.windows.manual.php[+手动指令步骤+]。
-2. 下载完成后，运行 ``.msi`` 安装文件。此时将启动安装向导。
-3. 在“Apache 配置目录”面板上，指定 ``httpd.conf`` 文件所在的目录，默认设置是 ``C:\Program Files\Apache Software Foundation\Apache<version>\conf\`` 。PHP 处理将自动启用。
-4. 如果您要使用 MySQL 数据库服务器，请选择“完全”安装选项，或在“扩展”列表中选择 "MySQL" 和 "MySQLi" 项。
-5. 安装完成后，请重新启动 Apache 服务器。
-6. 要检查 PHP 引擎是否已成功安装，以及是否在 Apache 配置中启用了 PHP 处理，请执行以下操作：
+
+[start=2]
+. 下载完成后，运行 ``.msi`` 安装文件。此时将启动安装向导。
+
+[start=3]
+. 在“Apache 配置目录”面板上，指定 ``httpd.conf`` 文件所在的目录，默认设置是 ``C:\Program Files\Apache Software Foundation\Apache<version>\conf\`` 。PHP 处理将自动启用。
+
+[start=4]
+. 如果您要使用 MySQL 数据库服务器，请选择“完全”安装选项，或在“扩展”列表中选择 "MySQL" 和 "MySQLi" 项。
+
+[start=5]
+. 安装完成后，请重新启动 Apache 服务器。
+
+[start=6]
+. 要检查 PHP 引擎是否已成功安装，以及是否在 Apache 配置中启用了 PHP 处理，请执行以下操作：
* 打开记事本或其他文本编辑器。创建一个文件并键入以下文本：
[source,php]
@@ -235,6 +267,7 @@ image::images/install-apache-it-works-port80.png[]
----
* 在 htdocs 文件夹中将此文件另存为 `test.php`。默认路径为 ``C:\Program Files\Apache Software Foundation\Apache<version>\htdocs\test.php``
* 运行浏览器，然后输入以下 URL： ``http://localhost:<port>/test.php`` 。以下页面打开：
+
image::images/install-php-test.png[]
@@ -245,14 +278,18 @@ image::images/install-php-test.png[]
1. 重新启动 Apache 服务器。
2. 检查 Apache 服务器配置文件 httpd.conf 是否包含以下几行：
-[source,java]
+[source,ini]
----
AddType Application/x-httpd-php .php
LoadModule php5_module "c:/php/sapi/php5apache2_2.dll"
----
-3. 如果缺少以上几行，请添加它们，并保存 ``httpd.conf`` ，然后重新启动 Apache。
-4. 刷新 http://localhost:<port>/test.php 页面。
+
+[start=3]
+. 如果缺少以上几行，请添加它们，并保存 ``httpd.conf`` ，然后重新启动 Apache。
+
+[start=4]
+. 刷新 http://localhost:<port>/test.php 页面。
=== MySQL 数据库服务器
@@ -268,14 +305,18 @@ image::images/install-php-test.png[]
=== 设置环境
-1. 如果按照默认设置安装，则系统会自动启用 PHP 处理。
-2. 要将
+
+[start=1]
+. 如果按照默认设置安装，则系统会自动启用 PHP 处理。
+
+[start=2]
+. 要将
XDebug 附加到 PHP 引擎，请找到 ``php.ini`` 文件，并在其中添加以下几行：
适用于*线程安全*的 PHP 5.2 引擎：
-[source,java]
+[source,ini]
----
zend_extension_ts="<path to the php folder>/php_xdebug-<version-number>.dll"
@@ -285,7 +326,7 @@ xdebug.remote_enable=1
适用于*非线程安全*的 PHP 5.2 引擎：
-[source,java]
+[source,ini]
----
zend_extension_nts="<path to the php folder>/php_xdebug-<version-number>.dll"
@@ -295,7 +336,7 @@ xdebug.remote_enable=1
适用于*任何* PHP 5.3 引擎：
-[source,java]
+[source,ini]
----
zend_extension="<path to the php folder>/php_xdebug-<version-number>.dll"
@@ -305,7 +346,7 @@ xdebug.remote_enable=1
一些用户还发现需要包括以下行（但有些用户不需要）：
-[source,java]
+[source,ini]
----
xdebug.remote_host=127.0.0.1xdebug.remote_port=9000
@@ -314,9 +355,12 @@ xdebug.remote_host=127.0.0.1xdebug.remote_port=9000
有关如何配置 XDebug 的详细信息，请单击link:http://www.xdebug.org/docs/install[+此处+]。
-*注：*请确保您指定的路径与安装过程中所确定的相应文件的名称和位置匹配。
+NOTE: 请确保您指定的路径与安装过程中所确定的相应文件的名称和位置匹配。
+
+
+[start=3]
+. 要确保先前安装的 PHP 引擎支持使用 MySQL 数据库服务器，请执行以下操作：
-3. 要确保先前安装的 PHP 引擎支持使用 MySQL 数据库服务器，请执行以下操作：
1. 单击“开始”>“控制面板”。
2. 在控制面板上，选择“添加或删除程序”。
3. 在“添加或删除程序”面板上，选择“PHP <版本号>”区域并单击“更改”。此时将启动 PHP 设置向导。单击 "Next"（下一步）。
diff --git a/netbeans.apache.org/src/content/kb/docs/php/debugging.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/debugging.asciidoc
index a1e36ab..d2e6ea0 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/debugging.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/debugging.asciidoc
@@ -105,19 +105,19 @@ image::images/debugger-toolbar2.png[title="Debugger toolbar in suspended state"]
The toolbar provides you with the following actions:
|===
-|*Finish Session* ( image::images/finish-session-button.png[] ) |Finish debugging session
+|*Finish Session* ( image:images/finish-session-button.png[] ) |Finish debugging session
-|*Pause* ( image::images/pause-button.png[] ) |Suspend debugging session
+|*Pause* ( image:images/pause-button.png[] ) |Suspend debugging session
-|*Resume* ( image::images/resume-button.png[] ) |Resume debugging session
+|*Resume* ( image:images/resume-button.png[] ) |Resume debugging session
-|*Step Over* ( image::images/step-over-button.png[] ) |Step over an execution statement
+|*Step Over* ( image:images/step-over-button.png[] ) |Step over an execution statement
-|*Step Into* ( image::images/step-into-button.png[] ) |Step into a function call
+|*Step Into* ( image:images/step-into-button.png[] ) |Step into a function call
-|*Step Out* ( image::images/step-out-button.png[] ) |Step out of the current function call
+|*Step Out* ( image:images/step-out-button.png[] ) |Step out of the current function call
-|*Run to Cursor* ( image::images/run-to-cursor-button.png[] ) |Run execution to the position of the cursor
+|*Run to Cursor* ( image:images/run-to-cursor-button.png[] ) |Run execution to the position of the cursor
|===
@@ -133,9 +133,9 @@ To set a breakpoint, click in the left margin of the editor on the line where yo
image::images/set-breakpoint.png[title="Breakpoints can be set in the editor"]
-You can remove the breakpoint by clicking on the breakpoint badge ( image::images/breakpoint-badge.png[] ).
+You can remove the breakpoint by clicking on the breakpoint badge ( image:images/breakpoint-badge.png[] ).
-It is also possible to temporarily disable breakpoints. To do so, right-click on a breakpoint badge and unselect Breakpoint > ✔Enabled. This toggles the breakpoint into a disabled state, resulting in a grey badge ( image::images/disabled-breakpoint-badge.png[] ) displaying in the left margin.
+It is also possible to temporarily disable breakpoints. To do so, right-click on a breakpoint badge and unselect Breakpoint > ✔Enabled. This toggles the breakpoint into a disabled state, resulting in a grey badge ( image:images/disabled-breakpoint-badge.png[] ) displaying in the left margin.
If the debugger encounters a breakpoint upon executing, it stops on the breakpoint, enabling you to examine variables in the debugging windows, and step through any code following the breakpoint.
@@ -176,7 +176,7 @@ The NetBeans IDE also enables you to run multiple debugger sessions simultaneous
image::images/sessions-win2.png[]
-The current session (i.e., the session that you can control using the debugger toolbar) is indicated by the more prominent icon ( image::images/current-session-icon.png[] ). To switch sessions, you can double-click on the session you want to make current, or right-click a non-current session and choose Make Current.
+The current session (i.e., the session that you can control using the debugger toolbar) is indicated by the more prominent icon ( image:images/current-session-icon.png[] ). To switch sessions, you can double-click on the session you want to make current, or right-click a non-current session and choose Make Current.
*Note: *It is not recommended to switch sessions if the session you are currently working in is suspended.
@@ -238,11 +238,20 @@ The following procedure is the workflow of a typical debugging session.
1. Start the ide and open the file that contains the source code that you want to debug.
2. Set a breakpoint at each line where you want the debugger to pause. To set a breakpoint, place the cursor at the beginning of a line and press Ctrl-F8/⌘-F8 or choose Debug > Toggle Line Breakpoint.
3. In the Projects window, navigate to the current project node, click the right mouse button, and choose Debug from the popup menu. The IDE opens the Debugger windows and runs the project in the debugger until the breakpoint is reached.
-NOTE: If the current project is set as Main, you can choose Debug > Debug Main Project, or press Ctrl-F5, or click image::images/debug-main-project-button.png[].
-4. Switch to the Local Variables window. The window shows all the variables that have been initialized within the current function, their types, and values.
-5. To view the value of a variable outside the function, bring the cursor on an occurrence of the variable. The tooltip shows the variable value.
-6. To execute the program line by line including the lines within all the called functions, press F7 or choose Debug > Step Into and watch the changes to the variables' values in the Local Variables window.
-7. To check the logic of the program by watching the changes of expressions, define a new watch:
+NOTE: If the current project is set as Main, you can choose Debug > Debug Main Project, or press Ctrl-F5, or click image:images/debug-main-project-button.png[].
+
+[start=4]
+. Switch to the Local Variables window. The window shows all the variables that have been initialized within the current function, their types, and values.
+
+[start=5]
+. To view the value of a variable outside the function, bring the cursor on an occurrence of the variable. The tooltip shows the variable value.
+
+[start=6]
+. To execute the program line by line including the lines within all the called functions, press F7 or choose Debug > Step Into and watch the changes to the variables' values in the Local Variables window.
+
+[start=7]
+. To check the logic of the program by watching the changes of expressions, define a new watch:
+
1. To open the Watches window, choose Window > Debugging > Watches or press Ctrl-Shift-2. The Watches window opens.
2. Anywhere inside the Watches window, click the right mouse button and choose New Watch from the popup menu. The New Watch window opens.
3. Enter the watch expression and click OK.
@@ -251,12 +260,24 @@ Now you can make an additional check during debugging.
*Important:* You must enable watches in the <<options,Debugging tab of PHP Options>> in order to set watches.
-8. To cancel the line by line execution of the code within a function and spring to the next line after the function call, press Ctrl-F7/⌘-F7 or choose Debug > Step Out.
-9. To skip the line by line execution of the code in a function, get the value returned by the function, and spring to the next line after the function call, press F8 or choose Debug > Step Over.
-10. To pause the debugging session, choose Debug > Pause.
-11. To continue the debugging session, choose Debug > Continue or press image::images/continue-debugging-session.png[].
-12. To cancel the debugging session, press image::images/stop-debugging-session.png[].
-13.
+
+[start=8]
+. To cancel the line by line execution of the code within a function and spring to the next line after the function call, press Ctrl-F7/⌘-F7 or choose Debug > Step Out.
+
+[start=9]
+. To skip the line by line execution of the code in a function, get the value returned by the function, and spring to the next line after the function call, press F8 or choose Debug > Step Over.
+
+[start=10]
+. To pause the debugging session, choose Debug > Pause.
+
+[start=11]
+. To continue the debugging session, choose Debug > Continue or press image:images/continue-debugging-session.png[].
+
+[start=12]
+. To cancel the debugging session, press image:images/stop-debugging-session.png[].
+
+[start=13]
+.
When the program reaches the end, the debugger windows close.
@@ -269,46 +290,121 @@ The sample in this section illustrates the basic debugger functions, including s
* Sources location - the default ``htdocs`` folder location
* Run configuration - Local Web Site
Find more details about setting up a PHP project in the document link:project-setup.html[+Setting Up a PHP Project+].
-2. To enable the use of hotkeys during the session, position the cursor on the project node and choose Set as Main Project from the popup menu.
-3. In the ``index.php`` file, enter the following code:
+
+[start=2]
+. To enable the use of hotkeys during the session, position the cursor on the project node and choose Set as Main Project from the popup menu.
+
+[start=3]
+. In the ``index.php`` file, enter the following code:
[source,php]
----
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+ <title>NetBeans PHP debugging sample</title>
+ </head>
+<body>
+<?php
+ $m=5;
+ $n=10;
+ $sum_of_factorials = calculate_sum_of_factorials ($m, $n);
+ echo "The sum of factorials of the entered integers is " . $sum_of_factorials;
+ function calculate_sum_of_factorials ($argument1, $argument2) {
+ $factorial1 = calculate_factorial ($argument1);
+ $factorial2 = calculate_factorial ($argument2);
+ $result = calculate_sum ($factorial1, $factorial2);
+ return $result;
+ }
+ function calculate_factorial ($argument) {
+ $factorial_result = 1;
+ for ($i=1; $i<=$argument; $i++) {
+ $factorial_result = $factorial_result*$i;
+ }
+ return $factorial_result;
+ }
+ function calculate_sum ($argument1, $argument2) {
+ return $argument1 + $argument2;
+ }
+?>
+</body>
+</html>
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>NetBeans PHP debugging sample</title></head><body><?php$m=5;$n=10;$sum_of_factorials = calculate_sum_of_factorials ($m, $n);echo "The sum of factorials of the entered integers is " . $sum_of_factorials;function calculate_sum_of_factorials ($argument1, $argument2) {$factorial1 = calculate_factorial ($argument1);$factorial2 = calculate_facto [...]
----
The code contains three functions:
* The ``calculate_factorial ()`` function
* The ``calcualte_sum ()`` function
* The ``calculate_sum_of_factorials ()`` function that calls the ``calculate_factorial`` function twice, then calls the ``calcualte_sum ()`` function once, and returns the calculated sum of factorials.
-4. Set a breakpoint (Ctrl-F8/⌘-F8) at the beginning of the PHP block:
+
+[start=4]
+. Set a breakpoint (Ctrl-F8/⌘-F8) at the beginning of the PHP block:
[source,php]
----
<?php
----
-5. To start debugging, click image::images/debug-main-project-button.png[]. The debugger stops at the breakpoint.
-6. Press F7 three times. The debugger stops at the line where the function ``calculate_sum_of_factorials ()`` is called. The Local Variables window shows the variables ``$m`` and ``$n`` with their values:
+
+[start=5]
+. To start debugging, click image:images/debug-main-project-button.png[]. The debugger stops at the breakpoint.
+
+[start=6]
+. Press F7 three times. The debugger stops at the line where the function ``calculate_sum_of_factorials ()`` is called. The Local Variables window shows the variables ``$m`` and ``$n`` with their values:
+
image::images/degugger-stopped-at-function-call.png[]
-7. To step into the function ``calculate_sum_of_factorials()`` , press F7. The debugger starts to execute the code within the function ``calculate_sum_of_factorials ()`` and stops at the call of the function ``calculate_factorial()`` .
+
+
+[start=7]
+. To step into the function ``calculate_sum_of_factorials()`` , press F7. The debugger starts to execute the code within the function ``calculate_sum_of_factorials ()`` and stops at the call of the function ``calculate_factorial()`` .
+
image::images/call-of-embedded-function.png[]
+
The Local Variables window now shows the local variables ``$argument1`` and ``$argument2`` that are declared within the function ``calculate_sum_of_factorials ()`` .
+
image::images/variables-inside-function-call-another-function.png[]
-8. Press F7. The debugger starts to execute the code with the function ``calculate_factorial()`` . The Call Stack window shows the stack of calls to the functions in the reverse order with the last called function at the top of the list:
+
+
+[start=8]
+. Press F7. The debugger starts to execute the code with the function ``calculate_factorial()`` . The Call Stack window shows the stack of calls to the functions in the reverse order with the last called function at the top of the list:
+
image::images/call-stack.png[]
-9. Press F7 to step into the loop. View the values of the variables in the Variables window.
+
+
+[start=9]
+. Press F7 to step into the loop. View the values of the variables in the Variables window.
+
image::images/local-variables-inside-loop.png[]
-10. When you make sure that the code works correctly, press Ctrl-F7/⌘-F7 to cancel the function execution. The program returns to the line next after the call of the function ``calculate_factorial()`` .
+
+
+[start=10]
+. When you make sure that the code works correctly, press Ctrl-F7/⌘-F7 to cancel the function execution. The program returns to the line next after the call of the function ``calculate_factorial()`` .
NOTE: Alternatively, you can press F7 until the program completes execution of the function ``calculate_factorial()`` . You will also return to the line next after its call.
+
image::images/call-of-embedded-function-second-time.png[]
-11. Because you have just checked the function ``calculate_factorial()`` and know that it works correctly, you can skip its execution ("step over"). To step over, press F8. The program stops at the call of the function ``calculate_sum()`` .
+
+
+[start=11]
+. Because you have just checked the function ``calculate_factorial()`` and know that it works correctly, you can skip its execution ("step over"). To step over, press F8. The program stops at the call of the function ``calculate_sum()`` .
+
image::images/cal-of-embedded-function-calculate-sum.png[]
-12. To step into the function ``calculate_sum()`` , press F7.
-13. To step over, press F8. In either case the debugger stops at the last line in the function ``calculate_sum_of_factorials()`` .
+
+
+[start=12]
+. To step into the function ``calculate_sum()`` , press F7.
+
+[start=13]
+. To step over, press F8. In either case the debugger stops at the last line in the function ``calculate_sum_of_factorials()`` .
+
image::images/return-result.png[]
-14. Press F7. The debugger moves to the line with the ``echo`` statement.
-15. Press F7 till the debugger exits the program. The browser window opens and shows the result of program execution:
+
+
+[start=14]
+. Press F7. The debugger moves to the line with the ``echo`` statement.
+
+[start=15]
+. Press F7 till the debugger exits the program. The browser window opens and shows the result of program execution:
+
image::images/program-output.png[]
@@ -320,30 +416,37 @@ You can define an additional watch expression to follow up your program executio
1. Update the code as follows (replace a plus with a minus):
-[source,java]
+[source,php]
----
-
function calculate_sum ($argument1, $argument2) {return $argument1 - argument2;}
----
Suppose that this resulted from misspelling but actually you need to calculate sum.
-2. Choose Debug > New Watch or press Ctrl/⌘-shift-F7. The New Watch window opens.
-3. Enter the following expression and click OK.
-[source,java]
+[start=2]
+. Choose Debug > New Watch or press Ctrl/⌘-shift-F7. The New Watch window opens.
+
+[start=3]
+. Enter the following expression and click OK.
+
+[source,php]
----
$factorial1+$factorial2
----
The new expression appears in the Watches window.
-4. Run the debugging session. When the debugger stops at the line
-[source,java]
+[start=4]
+. Run the debugging session. When the debugger stops at the line
+
+[source,php]
----
return $result;
----
compare the value of the expression in the Watches window and the value of $result in the Local Variables window. They should be the same but they differ.
+
image::images/watches.png[]
+
This example is very simple and is supposed to give some general notion of using watches.
@@ -353,32 +456,51 @@ You can debug code that contains both PHP and HTML blocks. In the example from t
1. Add the following HTML code above the <?php ?> block:
-[source,xml]
+[source,html]
----
-
- <form action="index.php" method="POST">Enter the first integer, please:<input type="text" name="first_integer"/><br/>Enter the second integer, please:<input type="text" name="second_integer"/><br/><input type="submit" name="enter" value="Enter"/></form>
+ <form action="index.php" method="POST">
+ Enter the first integer, please:<input type="text" name="first_integer"/>
+ <br/>
+ Enter the second integer, please:<input type="text" name="second_integer"/>
+ <br/>
+ <input type="submit" name="enter" value="Enter"/>
+ </form>
----
Find more information about link:wish-list-lesson2.html#htmlForm[+HTML input forms+].
-2. Replace the following lines at the top of the <?php ?> block:
-[source,java]
-----
+[start=2]
+. Replace the following lines at the top of the <?php ?> block:
-$m=5;$n=10;$sum_of_factorials = calculate_sum_of_factorials ($m, $n);echo "The sum of factorials of the entered integers is " . $sum_of_factorials;
+[source,php]
+----
+$m=5;
+$n=10;
+$sum_of_factorials = calculate_sum_of_factorials ($m, $n);
+echo "The sum of factorials of the entered integers is " . $sum_of_factorials;
----
with the following code:
-[source,java]
+[source,php]
----
-
-if (array_key_exists ("first_integer", $_POST) && array_key_exists ("second_integer", $_POST)) {$result = calculate_sum_of_factorials ($_POST["first_integer"], $_POST["second_integer"]);echo "Sum of factorials is " . $result;}
+if (array_key_exists ("first_integer", $_POST) && array_key_exists ("second_integer", $_POST)) {
+ $result = calculate_sum_of_factorials ($_POST["first_integer"], $_POST["second_integer"]);
+ echo "Sum of factorials is " . $result;
+}
----
-3. Set a breakpoint at the beginning of the <?php ?> block and start the <<debuggingSession,debugging session>>.
-4. Press F7. The debugger steps into the program. The browser window opens but the input form is not displayed. This is correct behavior of the debugger because it has to pass through the entire source code of a web page before the page can be displayed. Practically, this means that the debugger passes through the code twice. First time the debugger processes the code to display the HTML input form. The second time the debugger executes PHP code step by step.
-5. Press F7 till the debugger reaches the end of the program and the input form opens.
-6. Fill in the form and click Enter. The debugging session continues as described in section <<sampleDebuggingSession,Sample Debugging Session>>.
+
+[start=3]
+. Set a breakpoint at the beginning of the <?php ?> block and start the <<debuggingSession,debugging session>>.
+
+[start=4]
+. Press F7. The debugger steps into the program. The browser window opens but the input form is not displayed. This is correct behavior of the debugger because it has to pass through the entire source code of a web page before the page can be displayed. Practically, this means that the debugger passes through the code twice. First time the debugger processes the code to display the HTML input form. The second time the debugger executes PHP code step by step.
+
+[start=5]
+. Press F7 till the debugger reaches the end of the program and the input form opens.
+
+[start=6]
+. Fill in the form and click Enter. The debugging session continues as described in section <<sampleDebuggingSession,Sample Debugging Session>>.
== [[ Path Mapping, Debugger Proxy, and Starting a Debug Session on a Custom URL]]
@@ -395,7 +517,9 @@ It is possible to debug both scripts and web pages, and web pages can be debugge
* Ask Every Time, which has the IDE prompt you for the URL when you start a debugging session.
* Do Not Open Web Browser, which requires you to open the browser and enter the URL manually (you need the GET/POST XDEBUG_SESSION_START variable).
-6. If you are using a proxy server for debugging, enter the server's host name and port in the Debugger Proxy section.
+
+[start=6]
+. If you are using a proxy server for debugging, enter the server's host name and port in the Debugger Proxy section.
For more information, please see the link:http://blogs.oracle.com/netbeansphp/entry/path_mapping_in_php_debugger[+Path Mapping in PHP Debugger+] post in the Net Beans for PHP blog.
diff --git a/netbeans.apache.org/src/content/kb/docs/php/debugging_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/debugging_ja.asciidoc
index 32ade9c..5bd0250 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/debugging_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/debugging_ja.asciidoc
@@ -29,10 +29,6 @@
:description: NetBeans IDEでのPHPソース・コードのデバッグ - Apache NetBeans
:keywords: Apache NetBeans, Tutorials, NetBeans IDEでのPHPソース・コードのデバッグ
-
-image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、NetBeans IDE 7.2、7.3、7.4および8.0に適用されます"]
-
-
*このチュートリアルに従うには、次のソフトウェアとリソースが必要です。*
|===
@@ -72,7 +68,7 @@ NetBeans IDEには、ファイルのステップ実行に役立つデバッグ
NetBeans IDEの「オプション」には、PHPをデバッグするための特定のデフォルト設定を変更するタブが含まれています。これらのオプションを開くには、「ツール」>「オプション」(Macの場合は「NetBeans」>「プリファレンス」)に移動し、「PHP」オプションを選択して、「デバッグ」タブを選択します。
-*注意: *「デバッグ」タブはNetBeans IDEバージョン7.1で導入されました。以前のバージョンのNetBeansでは、デバッグ・オプションは「一般」-「PHP」タブにあります。バージョン7.1のすべてのオプションが以前のバージョンで使用できるわけではありません。
+NOTE: 「デバッグ」タブはNetBeans IDEバージョン7.1で導入されました。以前のバージョンのNetBeansでは、デバッグ・オプションは「一般」-「PHP」タブにあります。バージョン7.1のすべてのオプションが以前のバージョンで使用できるわけではありません。
image::images/php-debugging-options.png[]
@@ -87,7 +83,7 @@ image::images/php-debugging-options.png[]
* *リクエストされたURLを表示。*デバッグ中に新しい「出力」ウィンドウを開きます。この「出力」ウィンドウは「PHPでリクエストされたURL」という名前で、現在処理されているURLを示します。URLはクリック可能です。「出力」ウィンドウのURLをクリックすると、URLがブラウザ・ウィンドウで開きます。
* *PHPデバッガ・コンソール。*デバッグされたスクリプトの出力を表示する新しい「出力」ウィンドウを開きます。
-*注意:* ``php.ini`` ファイルで ``output_buffering=Off`` と設定してください。そうしないと、「出力」ウィンドウにスクリプト出力が表示される際に遅延が生じます。
+NOTE: ``php.ini`` ファイルで ``output_buffering=Off`` と設定してください。そうしないと、「出力」ウィンドウにスクリプト出力が表示される際に遅延が生じます。
このチュートリアルでは、ウォッチをオプションで有効にする場合を除いて、これらの設定を変更する必要はありません。
@@ -111,19 +107,19 @@ image::images/debugger-toolbar2.png[title="一時停止状態のデバッガ・
ツールバーでは次のアクションを実行できます。
|===
-|*セッションの終了*(image::images/finish-session-button.png[]) |デバッグ・セッションを終了
+|*セッションの終了*(image:images/finish-session-button.png[]) |デバッグ・セッションを終了
-|*一時休止*(image::images/pause-button.png[]) |デバッグ・セッションを一時停止
+|*一時休止*(image:images/pause-button.png[]) |デバッグ・セッションを一時停止
-|*再開*(image::images/resume-button.png[]) |デバッグ・セッションを再開
+|*再開*(image:images/resume-button.png[]) |デバッグ・セッションを再開
-|*ステップ・オーバー*(image::images/step-over-button.png[]) |実行文をステップ・オーバー
+|*ステップ・オーバー*(image:images/step-over-button.png[]) |実行文をステップ・オーバー
-|*ステップ・イン*(image::images/step-into-button.png[]) |関数コールにステップ・イン
+|*ステップ・イン*(image:images/step-into-button.png[]) |関数コールにステップ・イン
-|*ステップ・アウト*(image::images/step-out-button.png[]) |現在の関数コールからステップ・アウト
+|*ステップ・アウト*(image:images/step-out-button.png[]) |現在の関数コールからステップ・アウト
-|*カーソルまで実行*(image::images/run-to-cursor-button.png[]) |カーソル位置まで実行
+|*カーソルまで実行*(image:images/run-to-cursor-button.png[]) |カーソル位置まで実行
|===
@@ -139,9 +135,9 @@ image::images/debugger-toolbar2.png[title="一時停止状態のデバッガ・
image::images/set-breakpoint.png[title="エディタ内でのブレークポイントの設定"]
-ブレークポイントを除去するには、ブレークポイント・バッジ(image::images/breakpoint-badge.png[])をクリックします。
+ブレークポイントを除去するには、ブレークポイント・バッジ(image:images/breakpoint-badge.png[])をクリックします。
-ブレークポイントは一時的に無効にすることもできます。これを行うには、ブレークポイント・バッジを右クリックし、「ブレークポイント」>「✓有効」を選択解除します。これにより、ブレークポイントが無効な状態に切り替わり、左マージンにグレーのバッジ(image::images/disabled-breakpoint-badge.png[])が表示されます。
+ブレークポイントは一時的に無効にすることもできます。これを行うには、ブレークポイント・バッジを右クリックし、「ブレークポイント」>「✓有効」を選択解除します。これにより、ブレークポイントが無効な状態に切り替わり、左マージンにグレーのバッジ(image:images/disabled-breakpoint-badge.png[])が表示されます。
デバッグの実行中にブレークポイントに到達すると、デバッガはそのブレークポイントで停止するので、デバッグ・ウィンドウで変数を確認し、ブレークポイントに続くコードをステップ実行できます。
@@ -182,9 +178,9 @@ NetBeans IDEでは、複数のデバッガ・セッションを同時に実行
image::images/sessions-win2.png[]
-現在のセッション、つまりデバッガ・ツールバーを使用して制御できるセッションは、他のアイコンよりも目立つアイコン(image::images/current-session-icon.png[])で示されます。複数のセッションを切り替えるには、現在のセッションにするセッションをダブルクリックするか、現在でないセッションを右クリックして「現在に設定」を選択します。
+現在のセッション、つまりデバッガ・ツールバーを使用して制御できるセッションは、他のアイコンよりも目立つアイコン(image:images/current-session-icon.png[])で示されます。複数のセッションを切り替えるには、現在のセッションにするセッションをダブルクリックするか、現在でないセッションを右クリックして「現在に設定」を選択します。
-*注意: *現在作業中のセッションが一時停止されている場合、セッションを切り替えることはお薦めできません。
+NOTE: 現在作業中のセッションが一時停止されている場合、セッションを切り替えることはお薦めできません。
また、右クリックして表示されるポップアップ・ウィンドウを使用して、セッションを終了したり(右クリックして「終了」を選択)、現在のスレッドのデバッグとセッション内のすべてのスレッドのデバッグを切り替えたり(右クリックして「スコープ」>「すべてのスレッドをデバッグ」または「現在のスレッドをデバッグ」を選択)できます。
@@ -244,25 +240,45 @@ image::images/breakpoints-win.png[]
1. IDEを起動し、デバッグするソース・コードが含まれるファイルを開きます。
2. デバッガを一時休止する必要がある各行にブレークポイントを設定します。ブレークポイントを設定するには、行の先頭にカーソルを置き、[Ctrl]-[F8]/[⌘]-[F8]を押すか、または「デバッグ」>「行ブレークポイントを切替え」を選択します。
3. 「プロジェクト」ウィンドウで現在のプロジェクト・ノードに移動し、マウスの右ボタンをクリックして、ポップアップ・メニューから「デバッグ」を選択します。IDEでデバッガ・ウィンドウが開き、ブレークポイントに達するまで、デバッガでプロジェクトが実行されます。
-*注意:* 現在のプロジェクトがメインに設定されている場合は、「デバッグ」>「メイン・プロジェクトをデバッグ」を選択するか、[Ctrl]-[F5]を押すか、またはimage::images/debug-main-project-button.png[]をクリックできます。
-4. 「ローカル変数」ウィンドウに切り替えます。このウィンドウには、現在の関数内で初期化されたすべての変数、その型、および値が表示されます。
-5. 関数外の変数の値を表示するには、その変数の出現箇所にカーソルを置きます。ツールチップに変数の値が表示されます。
-6. コールしているすべての関数内の行を含めてプログラムを1行ずつ実行するには、[F7]を押すか、「デバッグ」>「ステップ・イン」を選択して、「ローカル変数」ウィンドウで変数の値の変化をウォッチします。
-7. 式の変化をウォッチしてプログラムのロジックを確認するには、次の手順で新しいウォッチを定義します。
-1. 「ウォッチ」ウィンドウを開くには、「ウィンドウ」>「デバッグ」>「ウォッチ」を選択するか、または[Ctrl]-[Shift]-[2]を押します。「ウォッチ」ウィンドウが開きます。
-2. 「ウォッチ」ウィンドウ内の任意の場所でマウスの右ボタンをクリックし、ポップアップ・メニューから「新規ウォッチ」を選択します。「新規ウォッチ」ウィンドウが開きます。
-3. ウォッチ式を入力し、「OK」をクリックします。
+NOTE: 現在のプロジェクトがメインに設定されている場合は、「デバッグ」>「メイン・プロジェクトをデバッグ」を選択するか、[Ctrl]-[F5]を押すか、またはimage:images/debug-main-project-button.png[]をクリックできます。
+
+[start=4]
+. 「ローカル変数」ウィンドウに切り替えます。このウィンドウには、現在の関数内で初期化されたすべての変数、その型、および値が表示されます。
+
+[start=5]
+. 関数外の変数の値を表示するには、その変数の出現箇所にカーソルを置きます。ツールチップに変数の値が表示されます。
+
+[start=6]
+. コールしているすべての関数内の行を含めてプログラムを1行ずつ実行するには、[F7]を押すか、「デバッグ」>「ステップ・イン」を選択して、「ローカル変数」ウィンドウで変数の値の変化をウォッチします。
+
+[start=7]
+. 式の変化をウォッチしてプログラムのロジックを確認するには、次の手順で新しいウォッチを定義します。
+.. 「ウォッチ」ウィンドウを開くには、「ウィンドウ」>「デバッグ」>「ウォッチ」を選択するか、または[Ctrl]-[Shift]-[2]を押します。「ウォッチ」ウィンドウが開きます。
+.. 「ウォッチ」ウィンドウ内の任意の場所でマウスの右ボタンをクリックし、ポップアップ・メニューから「新規ウォッチ」を選択します。「新規ウォッチ」ウィンドウが開きます。
+.. ウォッチ式を入力し、「OK」をクリックします。
これで、デバッグ中に追加の確認を行うことができます。
*重要:* ウォッチを設定するには、<<options,PHPオプションの「デバッグ」タブ>>でウォッチを有効にする必要があります。
-8. 関数内のコードの1行ずつの実行を取り消して、関数コールの次の行まで移動するには、[Ctrl]-[F7]/[⌘]-[F7]を押すか、または「デバッグ」>「ステップ・アウト」を選択します。
-9. 関数内のコードを1行ずつ実行しないで、関数から返される値を取得し、関数コールの次の行まで移動するには、[F8]を押すか、または「デバッグ」>「ステップ・オーバー」を選択します。
-10. デバッグ・セッションを一時休止するには、「デバッグ」>「一時休止」を選択します。
-11. デバッグ・セッションを続行するには、「デバッグ」>「続行」を選択するか、またはimage::images/continue-debugging-session.png[]を押します。
-12. デバッグ・セッションを取り消すには、image::images/stop-debugging-session.png[]を押します。
-13.
+
+[start=8]
+. 関数内のコードの1行ずつの実行を取り消して、関数コールの次の行まで移動するには、[Ctrl]-[F7]/[⌘]-[F7]を押すか、または「デバッグ」>「ステップ・アウト」を選択します。
+
+[start=9]
+. 関数内のコードを1行ずつ実行しないで、関数から返される値を取得し、関数コールの次の行まで移動するには、[F8]を押すか、または「デバッグ」>「ステップ・オーバー」を選択します。
+
+[start=10]
+. デバッグ・セッションを一時休止するには、「デバッグ」>「一時休止」を選択します。
+
+[start=11]
+. デバッグ・セッションを続行するには、「デバッグ」>「続行」を選択するか、またはimage:images/continue-debugging-session.png[]を押します。
+
+[start=12]
+. デバッグ・セッションを取り消すには、image:images/stop-debugging-session.png[]を押します。
+
+[start=13]
+.
プログラムの最後に到達すると、デバッガ・ウィンドウが閉じます。
@@ -275,46 +291,122 @@ image::images/breakpoints-win.png[]
* ソースの場所 - デフォルトの ``htdocs`` フォルダ
* 実行構成 - ローカルWebサイト
PHPプロジェクトの設定については、ドキュメントのlink:project-setup.html[+PHPプロジェクトの設定+]を参照してください。
-2. セッション中のホット・キーの使用を有効にするには、カーソルをプロジェクト・ノードに置き、ポップアップ・メニューから「メイン・プロジェクトとして設定」を選択します。
-3. ``index.php`` ファイルに次のコードを入力します。
+
+[start=2]
+. セッション中のホット・キーの使用を有効にするには、カーソルをプロジェクト・ノードに置き、ポップアップ・メニューから「メイン・プロジェクトとして設定」を選択します。
+
+[start=3]
+. ``index.php`` ファイルに次のコードを入力します。
[source,php]
----
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+ <title>NetBeans PHP debugging sample</title>
+ </head>
+<body>
+<?php
+ $m=5;
+ $n=10;
+ $sum_of_factorials = calculate_sum_of_factorials ($m, $n);
+ echo "The sum of factorials of the entered integers is " . $sum_of_factorials;
+ function calculate_sum_of_factorials ($argument1, $argument2) {
+ $factorial1 = calculate_factorial ($argument1);
+ $factorial2 = calculate_factorial ($argument2);
+ $result = calculate_sum ($factorial1, $factorial2);
+ return $result;
+ }
+ function calculate_factorial ($argument) {
+ $factorial_result = 1;
+ for ($i=1; $i<=$argument; $i++) {
+ $factorial_result = $factorial_result*$i;
+ }
+ return $factorial_result;
+ }
+ function calculate_sum ($argument1, $argument2) {
+ return $argument1 + $argument2;
+ }
+?>
+</body>
+</html>
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>NetBeans PHP debugging sample</title></head><body><?php$m=5;$n=10;$sum_of_factorials = calculate_sum_of_factorials ($m, $n);echo "The sum of factorials of the entered integers is " . $sum_of_factorials;function calculate_sum_of_factorials ($argument1, $argument2) {$factorial1 = calculate_factorial ($argument1);$factorial2 = calculate_facto [...]
----
+
このコードには次の3つの関数があります。
* ``calculate_factorial ()`` 関数
* ``calcualte_sum ()`` 関数
* ``calculate_sum_of_factorials ()`` 関数(この関数は、 ``calculate_factorial`` 関数を2回コールしてから ``calcualte_sum ()`` 関数を1回コールし、階乗の和を返します。)
-4. PHPブロックの先頭にブレークポイントを設定します([Ctrl]-[F8]/[⌘]-[F8])。
+
+[start=4]
+. PHPブロックの先頭にブレークポイントを設定します([Ctrl]-[F8]/[⌘]-[F8])。
[source,php]
----
<?php
----
-5. デバッグを開始するには、image::images/debug-main-project-button.png[]をクリックします。デバッガがブレークポイントで停止します。
-6. [F7]を3回押します。関数 ``calculate_sum_of_factorials ()`` をコールしている行でデバッガが停止します。「ローカル変数」ウィンドウに、変数 ``$m`` と ``$n`` 、およびそれらの値が表示されます。
+
+[start=5]
+. デバッグを開始するには、image:images/debug-main-project-button.png[]をクリックします。デバッガがブレークポイントで停止します。
+
+[start=6]
+. [F7]を3回押します。関数 ``calculate_sum_of_factorials ()`` をコールしている行でデバッガが停止します。「ローカル変数」ウィンドウに、変数 ``$m`` と ``$n`` 、およびそれらの値が表示されます。
+
image::images/degugger-stopped-at-function-call.png[]
-7. 関数 ``calculate_sum_of_factorials()`` にステップ・インするには、[F7]を押します。デバッガが関数 ``calculate_sum_of_factorials ()`` 内のコードの実行を開始し、関数 ``calculate_factorial()`` のコールで停止します。
+
+
+[start=7]
+. 関数 ``calculate_sum_of_factorials()`` にステップ・インするには、[F7]を押します。デバッガが関数 ``calculate_sum_of_factorials ()`` 内のコードの実行を開始し、関数 ``calculate_factorial()`` のコールで停止します。
+
image::images/call-of-embedded-function.png[]
+
「ローカル変数」ウィンドウに、関数 ``calculate_sum_of_factorials ()`` 内で宣言されているローカル変数 ``$argument1`` と ``$argument2`` が表示されます。
+
image::images/variables-inside-function-call-another-function.png[]
-8. [F7]を押します。デバッガが、関数 ``calculate_factorial()`` からコードの実行を開始します。「コール・スタック」ウィンドウに、関数へのコールのスタックが逆の順序で表示され、最後にコールされた関数がリストの先頭に表示されます。
+
+
+[start=8]
+. [F7]を押します。デバッガが、関数 ``calculate_factorial()`` からコードの実行を開始します。「コール・スタック」ウィンドウに、関数へのコールのスタックが逆の順序で表示され、最後にコールされた関数がリストの先頭に表示されます。
+
image::images/call-stack.png[]
-9. [F7]を押してループにステップ・インします。「変数」ウィンドウに変数の値が表示されます。
+
+
+[start=9]
+. [F7]を押してループにステップ・インします。「変数」ウィンドウに変数の値が表示されます。
+
image::images/local-variables-inside-loop.png[]
-10. コードが正常に機能することを確認したら、[Ctrl]-[F7]/[⌘]-[F7]を押して関数の実行を取り消します。プログラムは、関数 ``calculate_factorial()`` のコールの次の行に戻ります。
-*注意:* プログラムで関数 ``calculate_factorial()`` の実行が完了するまでは、[F7]を押すこともできます。この場合も、コールの次の行に戻ります。
+
+
+[start=10]
+. コードが正常に機能することを確認したら、[Ctrl]-[F7]/[⌘]-[F7]を押して関数の実行を取り消します。プログラムは、関数 ``calculate_factorial()`` のコールの次の行に戻ります。
+NOTE: プログラムで関数 ``calculate_factorial()`` の実行が完了するまでは、[F7]を押すこともできます。この場合も、コールの次の行に戻ります。
+
image::images/call-of-embedded-function-second-time.png[]
-11. 関数 ``calculate_factorial()`` が正常に機能することを確認できたため、その実行を省略できます(ステップ・オーバー)。ステップ・オーバーするには、[F8]を押します。プログラムは、関数 ``calculate_sum()`` のコールで停止します。
+
+
+[start=11]
+. 関数 ``calculate_factorial()`` が正常に機能することを確認できたため、その実行を省略できます(ステップ・オーバー)。ステップ・オーバーするには、[F8]を押します。プログラムは、関数 ``calculate_sum()`` のコールで停止します。
+
image::images/cal-of-embedded-function-calculate-sum.png[]
-12. 関数 ``calculate_sum()`` にステップ・インするには、[F7]を押します。
-13. ステップ・オーバーするには、[F8]を押します。いずれの場合も、デバッガは関数 ``calculate_sum_of_factorials()`` の最後の行で停止します。
+
+
+[start=12]
+. 関数 ``calculate_sum()`` にステップ・インするには、[F7]を押します。
+
+[start=13]
+. ステップ・オーバーするには、[F8]を押します。いずれの場合も、デバッガは関数 ``calculate_sum_of_factorials()`` の最後の行で停止します。
+
image::images/return-result.png[]
-14. [F7]を押します。デバッガは ``echo`` 文の行に移動します。
-15. デバッガがプログラムを終了するまで[F7]を押します。ブラウザ・ウィンドウが開き、プログラムの実行結果が表示されます。
+
+
+[start=14]
+. [F7]を押します。デバッガは ``echo`` 文の行に移動します。
+
+[start=15]
+. デバッガがプログラムを終了するまで[F7]を押します。ブラウザ・ウィンドウが開き、プログラムの実行結果が表示されます。
+
image::images/program-output.png[]
@@ -326,30 +418,38 @@ image::images/program-output.png[]
1. コードを次のように更新します(プラスをマイナスに置き換えます)。
-[source,java]
+[]
----
function calculate_sum ($argument1, $argument2) {return $argument1 - argument2;}
----
実際には和を求める必要がありますが、間違えてこのように入力したとします。
-2. 「デバッグ」>「新規ウォッチ」を選択するか、または[Ctrl]/[⌘]-[Shift]-[F7]を押します。「新規ウォッチ」ウィンドウが開きます。
-3. 次の式を入力し、「OK」をクリックします。
-[source,java]
+[start=2]
+. 「デバッグ」>「新規ウォッチ」を選択するか、または[Ctrl]/[⌘]-[Shift]-[F7]を押します。「新規ウォッチ」ウィンドウが開きます。
+
+[start=3]
+. 次の式を入力し、「OK」をクリックします。
+
+[]
----
$factorial1+$factorial2
----
新しい式が「ウォッチ」ウィンドウに表示されます。
-4. デバッグ・セッションを実行します。デバッガが次の行で停止します。
-[source,java]
+[start=4]
+. デバッグ・セッションを実行します。デバッガが次の行で停止します。
+
+[]
----
return $result;
----
「ウォッチ」ウィンドウ内の式の値と、「ローカル変数」ウィンドウ内の$resultの値を比較します。これらは同一である必要がありますが、現時点では異なります。
+
image::images/watches.png[]
+
この例は非常に単純で、ウォッチ使用の概念を示しています。
@@ -359,32 +459,47 @@ PHPとHTMLの両方のブロックを含むコードをデバッグできます
1. <?php?> ブロックの上に次のHTMLコードを追加します。
-[source,xml]
+[source,html]
----
-
- <form action="index.php" method="POST">Enter the first integer, please:<input type="text" name="first_integer"/><br/>Enter the second integer, please:<input type="text" name="second_integer"/><br/><input type="submit" name="enter" value="Enter"/></form>
+ <form action="index.php" method="POST">
+ Enter the first integer, please:<input type="text" name="first_integer"/>
+ <br/>
+ Enter the second integer, please:<input type="text" name="second_integer"/>
+ <br/>
+ <input type="submit" name="enter" value="Enter"/>
+ </form>
----
詳細は、link:wish-list-lesson2.html#htmlForm[+HTML入力フォーム+]を参照してください。
-2. <?php?>ブロックの先頭で、次の行を置き換えます。
-[source,java]
+[start=2]
+. <?php?>ブロックの先頭で、次の行を置き換えます。
+
+[]
----
$m=5;$n=10;$sum_of_factorials = calculate_sum_of_factorials ($m, $n);echo "The sum of factorials of the entered integers is " . $sum_of_factorials;
----
次のコードに置き換えます。
-[source,java]
+[]
----
if (array_key_exists ("first_integer", $_POST) && array_key_exists ("second_integer", $_POST)) {$result = calculate_sum_of_factorials ($_POST["first_integer"], $_POST["second_integer"]);echo "Sum of factorials is " . $result;}
----
-3. ブレークポイントを<?php?>ブロックの先頭に設定し、<<debuggingSession,デバッグ・セッション>>を開始します。
-4. [F7]を押します。デバッガがプログラムにステップ・インします。ブラウザ・ウィンドウが開きますが、入力フォームは表示されません。Webページが表示される前に、デバッガがページのソース・コード全体を通過する必要があるため、これはデバッガの正常な動作です。実際には、デバッガがコードを2回通過することを意味します。1回目は、HTML入力フォームを表示するコードがデバッガで処理されます。2回目は、デバッガでPHPコードがステップ実行されます。
-5. デバッガがプログラムの終わりに達し、入力フォームが開くまで[F7]を押します。
-6. フォームに入力して[Enter]を押します。デバッグ・セッションは、<<sampleDebuggingSession,デバッグ・セッションの例>>の項に示すように処理を続行します。
+
+[start=3]
+. ブレークポイントを<?php?>ブロックの先頭に設定し、<<debuggingSession,デバッグ・セッション>>を開始します。
+
+[start=4]
+. [F7]を押します。デバッガがプログラムにステップ・インします。ブラウザ・ウィンドウが開きますが、入力フォームは表示されません。Webページが表示される前に、デバッガがページのソース・コード全体を通過する必要があるため、これはデバッガの正常な動作です。実際には、デバッガがコードを2回通過することを意味します。1回目は、HTML入力フォームを表示するコードがデバッガで処理されます。2回目は、デバッガでPHPコードがステップ実行されます。
+
+[start=5]
+. デバッガがプログラムの終わりに達し、入力フォームが開くまで[F7]を押します。
+
+[start=6]
+. フォームに入力して[Enter]を押します。デバッグ・セッションは、<<sampleDebuggingSession,デバッグ・セッションの例>>の項に示すように処理を続行します。
== [[パス・マッピング、デバッガ・プロキシ、およびカスタムURLでのデバッグ・セッションの開始]]
@@ -401,7 +516,9 @@ if (array_key_exists ("first_integer", $_POST) && array_key_exists ("sec
* 毎回聞く: デバッグ・セッションを開始したとき、IDEによってURLの入力が求められます。
* Webブラウザを開かない: ブラウザを開いてURLを手動で入力するようにユーザーに求めます(GET/POST XDEBUG_SESSION_START変数が必要です)。
-6. デバッグ用のプロキシ・サーバーを使用する場合、「デバッガ・プロキシ」セクションにサーバーのホスト名とポートを入力します。
+
+[start=6]
+. デバッグ用のプロキシ・サーバーを使用する場合、「デバッガ・プロキシ」セクションにサーバーのホスト名とポートを入力します。
詳細は、PHP向けのNetBeansブログに投稿されたlink:http://blogs.oracle.com/netbeansphp/entry/path_mapping_in_php_debugger[+PHPデバッガでのパス・マッピング+]を参照してください。
diff --git a/netbeans.apache.org/src/content/kb/docs/php/debugging_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/debugging_pt_BR.asciidoc
index 0443f33..4e2f671 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/debugging_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/debugging_pt_BR.asciidoc
@@ -30,9 +30,6 @@
:keywords: Apache NetBeans, Tutorials, Depurando o Código-Fonte do PHP no NetBeans IDE
-image::images/netbeans-stamp-80-74-73.png[title="O conteúdo desta página se aplica ao NetBeans IDE 7.2, 7.3, 7.4 e 8.0"]
-
-
*Para seguir este tutorial, são necessários os recursos e o software a seguir.*
|===
@@ -72,7 +69,7 @@ O NetBeans IDE fornece uma barra de ferramentas de depuração que o ajuda a ent
As Opções do NetBeans IDE incluem uma guia para alterar determinadas definições default para PHP de depuração. Para abrir essas opções, acesse Ferramentas > Opções (NetBeans > Preferências no Mac), selecione as opções PHP e selecione a guia Depuração.
-*Observação: *a guia Depuração foi introduzida no NetBeans IDE versão 7.1. Versões anteriores do NetBeans têm as opções de depuração na guia Gerais PHP. Nem todas as opções da versão 7.1 estão disponíveis em versões anteriores.
+NOTE: a guia Depuração foi introduzida no NetBeans IDE versão 7.1. Versões anteriores do NetBeans têm as opções de depuração na guia Gerais PHP. Nem todas as opções da versão 7.1 estão disponíveis em versões anteriores.
image::images/php-debugging-options.png[]
@@ -87,7 +84,7 @@ Você pode alterar as seguintes opções neste painel:
* *Mostrar URLs Solicitados.* Abre uma nova janela de Saída durante a depuração. A janela de Saída é nomeada como URLs Solicitados por PHP e mostra os URLs processados atualmente. Os URLs são clicáveis. Clique em um URL na janela de Saída para abrir o URL em uma janela do browser.
* *Console do Depurador PHP* Abre uma nova janela de Saída que mostra a saída de scrpts depurados.
-*Observação:* defina ``output_buffering = Off`` em seu arquivo ``php.ini`` . Caso contrário, haverá um atraso em ver a saída do script na janela de Saída.
+NOTE: defina ``output_buffering = Off`` em seu arquivo ``php.ini`` . Caso contrário, haverá um atraso em ver a saída do script na janela de Saída.
Para o propósito deste tutorial, não é preciso alterar nenhuma destas definições, exceto, como opção, para ativar watches.
@@ -111,19 +108,19 @@ image::images/debugger-toolbar2.png[title="Barra de ferramentas do depurador no
A barra de ferramentas oferece as seguintes ações:
|===
-|*Finalizar Sessão* ( image::images/finish-session-button.png[] ) |Finalizar sessão de depuração
+|*Finalizar Sessão* ( image:images/finish-session-button.png[] ) |Finalizar sessão de depuração
-|*Pausar* ( image::images/pause-button.png[] ) |Suspender sessão de depuração
+|*Pausar* ( image:images/pause-button.png[] ) |Suspender sessão de depuração
-|*Retomar* ( image::images/resume-button.png[] ) |Retomar sessão de depuração
+|*Retomar* ( image:images/resume-button.png[] ) |Retomar sessão de depuração
-|*Fazer Step Over* ( image::images/step-over-button.png[] ) |Fazer step over de uma instrução de execução
+|*Fazer Step Over* ( image:images/step-over-button.png[] ) |Fazer step over de uma instrução de execução
-|*Fazer Step Into* ( image::images/step-into-button.png[] ) |Fazer step into em uma chamada de função
+|*Fazer Step Into* ( image:images/step-into-button.png[] ) |Fazer step into em uma chamada de função
-|*Fazer Step Out* ( image::images/step-out-button.png[] ) |Fazer step out da chamada de função atual
+|*Fazer Step Out* ( image:images/step-out-button.png[] ) |Fazer step out da chamada de função atual
-|*Executar até o Cursor* ( image::images/run-to-cursor-button.png[] ) |Executar até a posição do cursor
+|*Executar até o Cursor* ( image:images/run-to-cursor-button.png[] ) |Executar até a posição do cursor
|===
@@ -139,9 +136,9 @@ Para definir um ponto de interrupção, clique na margem esquerda do editor na l
image::images/set-breakpoint.png[title="Pontos de interrupção podem ser definidos no editor"]
-Você pode remover o ponto de interrupção clicando no emblema do ponto de interrupção ( image::images/breakpoint-badge.png[] ).
+Você pode remover o ponto de interrupção clicando no emblema do ponto de interrupção ( image:images/breakpoint-badge.png[] ).
-Também é possível desativar temporariamente os pontos de interrupção. Para isso, clique com o botão direito do mouse em um emblema de ponto de interrupção e desfaça a seleção de Ponto de interrupção > ✔Ativado. Isso alterna o ponto de interrupção para um estado desativado, resultando em um emblema cinza ( image::images/disabled-breakpoint-badge.png[] ) sendo exibido na margem esquerda.
+Também é possível desativar temporariamente os pontos de interrupção. Para isso, clique com o botão direito do mouse em um emblema de ponto de interrupção e desfaça a seleção de Ponto de interrupção > ✔Ativado. Isso alterna o ponto de interrupção para um estado desativado, resultando em um emblema cinza ( image:images/disabled-breakpoint-badge.png[] ) sendo exibido na margem esquerda.
Se o depurador encontrar um ponto de interrupção durante a execução, ele parará no ponto de interrupção, permitindo que você examine as variáveis nas janelas de depuração e entre em qualquer código depois do ponto de interrupção.
@@ -182,9 +179,9 @@ O NetBeans IDE também permite que você execute várias sessões do depurador s
image::images/sessions-win2.png[]
-A sessão atual (ou seja, a sessão que você pode controlar utilizando a barra de ferramentas do depurador) é indicada pelo ícone mais proeminente (image::images/current-session-icon.png[] ). Para alternar sessões, você pode clicar duas vezes na sessão que deseja tornar atual, ou clicar com o botão direito do mouse em uma sessão não atual e selecionar Tornar Atual.
+A sessão atual (ou seja, a sessão que você pode controlar utilizando a barra de ferramentas do depurador) é indicada pelo ícone mais proeminente (image:images/current-session-icon.png[] ). Para alternar sessões, você pode clicar duas vezes na sessão que deseja tornar atual, ou clicar com o botão direito do mouse em uma sessão não atual e selecionar Tornar Atual.
-*Observação: *Não recomendamos alternar entre sessões se a sessão em que está trabalhando no momento estiver suspensa.
+NOTE: Não recomendamos alternar entre sessões se a sessão em que está trabalhando no momento estiver suspensa.
Você também pode usar a janela pop-up do lado direito do mouse para encerrar uma sessão (clicar com o botão direito do mouse e selecionar Finalizar), ou alternar entre a depuração do thread atual ou todos os threads da sessão (clicar com o botão direito do mouse e selecionar Escopo > Depurar Todos os Threads ou Depurar Thread Atual).
@@ -244,26 +241,45 @@ O seguinte procedimento é o fluxo de trabalho de uma típica sessão de depura
1. Inicie o ide e abra o arquivo que contém o código-fonte que você deseja depurar.
2. Defina um ponto de interrupção em cada linha onde deseja que o depurador pause. Para definir um ponto de interrupção, coloque o cursor no início de uma linha e pressione Ctrl-F8⌘-F8 ou selecione Depurar > Alternar Ponto de Interrupção de Linha.
3. Na janela Projetos, navegue para o nó do projeto atual, clique com o botão direito do mouse e selecione Depurar do menu pop-up. O IDE abrirá as janelas do Depurador e executará o projeto no depurador, até que o ponto de interrupção seja atingido.
-*Observação:* se o projeto atual for definido como Principal, você poderá selecionar Depurar > Depurar Projeto Principal ou pressione Ctrl-F5 ou clique em image::images/debug-main-project-button.png[].
-4. Alterne para a janela Variáveis Locais. A janela mostra todas as variáveis que foram inicializadas na função atual, seus tipos e valores.
-5. Para exibir o valor de uma variável fora da função, coloque o cursor em uma ocorrência da variável. A dica de ferramenta mostra o valor da variável.
-6. Para executar o programa linha a linha, incluindo as linhas de todas as funções chamadas, pressione F7 ou selecione Depurar > Fazer Step Into e observe as alterações nos valores das variáveis na janela Variáveis Locais.
-7. Para verificar a lógica do programa observando as alterações das expressões, defina um novo watch:
-1. Para abrir a janela Watches, selecione Janela > Depuração > Watches ou pressione Ctrl-Shift-2. A janela Watches será aberta.
-2. Em qualquer lugar na janela Watches, clique com o botão direito do mouse e selecione Novo Watch do menu pop-up. A Janela Novo Watch será Aberta.
-3. Digite a expressão do watch e clique em OK.
+NOTE: se o projeto atual for definido como Principal, você poderá selecionar Depurar > Depurar Projeto Principal ou pressione Ctrl-F5 ou clique em image:images/debug-main-project-button.png[].
+
+[start=4]
+. Alterne para a janela Variáveis Locais. A janela mostra todas as variáveis que foram inicializadas na função atual, seus tipos e valores.
+
+[start=5]
+. Para exibir o valor de uma variável fora da função, coloque o cursor em uma ocorrência da variável. A dica de ferramenta mostra o valor da variável.
+
+[start=6]
+. Para executar o programa linha a linha, incluindo as linhas de todas as funções chamadas, pressione F7 ou selecione Depurar > Fazer Step Into e observe as alterações nos valores das variáveis na janela Variáveis Locais.
+
+[start=7]
+. Para verificar a lógica do programa observando as alterações das expressões, defina um novo watch:
+.. Para abrir a janela Watches, selecione Janela > Depuração > Watches ou pressione Ctrl-Shift-2. A janela Watches será aberta.
+.. Em qualquer lugar na janela Watches, clique com o botão direito do mouse e selecione Novo Watch do menu pop-up. A Janela Novo Watch será Aberta.
+.. Digite a expressão do watch e clique em OK.
Agora você pode fazer uma verificação adicional durante a depuração.
*Importante:* você precisa ativar os watches na <<options,guia Depuração das Opções PHP>> para poder definir watches.
-8. Para cancelar a execução linha a linha do código em uma função e passar para a próxima linha depois da chamada da função, pressione Ctrl-F7/⌘-F7 ou selecione Depurar > Fazer Step Out.
-9. Para ignorar a execução linha a linha do código em uma função, obtenha o valor retornado pela função e passe para a próxima linha depois da chamada da função, pressione F8 ou selecione Depurar > Fazer Step Over.
-10. Para pausar a sessão de depuração, selecione Depurar > Pausar.
-11. Para continuar a sessão de depuração, selecione Depurar > Continuar ou pressione image::images/continue-debugging-session.png[].
-12. Para cancelar a sessão de depuração, pressione image::images/stop-debugging-session.png[].
-13.
-Quando o programa chegar ao fim, as janelas do depurador serão fechadas.
+
+[start=8]
+. Para cancelar a execução linha a linha do código em uma função e passar para a próxima linha depois da chamada da função, pressione Ctrl-F7/⌘-F7 ou selecione Depurar > Fazer Step Out.
+
+[start=9]
+. Para ignorar a execução linha a linha do código em uma função, obtenha o valor retornado pela função e passe para a próxima linha depois da chamada da função, pressione F8 ou selecione Depurar > Fazer Step Over.
+
+[start=10]
+. Para pausar a sessão de depuração, selecione Depurar > Pausar.
+
+[start=11]
+. Para continuar a sessão de depuração, selecione Depurar > Continuar ou pressione image:images/continue-debugging-session.png[].
+
+[start=12]
+. Para cancelar a sessão de depuração, pressione image:images/stop-debugging-session.png[].
+
+[start=13]
+. Quando o programa chegar ao fim, as janelas do depurador serão fechadas.
== Sessão de Depuração de Amostra
@@ -275,8 +291,12 @@ A amostra nesta sessão ilustra as funções básicas do depurador, incluindo en
* Local dos códigos-fonte - o local default da pasta ``htdocs``
* Executar configuração: Web Site Local
Encontre mais detalhes sobre como configurar um projeto PHP no documento link:project-setup.html[+Configurando um Projeto PHP+].
-2. Para permitir o uso de teclas de atalho durante a sessão, posicione o cursor no nó do projeto e selecione Definir como Projeto Principal no menu pop-up.
-3. No arquivo ``index.php`` , digite o seguinte código:
+
+[start=2]
+. Para permitir o uso de teclas de atalho durante a sessão, posicione o cursor no nó do projeto e selecione Definir como Projeto Principal no menu pop-up.
+
+[start=3]
+. No arquivo ``index.php`` , digite o seguinte código:
[source,php]
----
@@ -287,34 +307,76 @@ O código contém três funções:
* A função ``calculate_factorial ()``
* A função ``calcualte_sum ()``
* A função ``calculate_sum_of_factorials ()`` que chama a função ``calculate_factorial`` duas vezes, depois chama a função ``calcualte_sum ()`` uma vez e retorna a soma calculada dos fatoriais.
-4. Definir um ponto de interrupção (Ctrl-F8/⌘-F8) no início do bloco PHP:
+
+[start=4]
+. Definir um ponto de interrupção (Ctrl-F8/⌘-F8) no início do bloco PHP:
[source,php]
----
<?php
----
-5. Para iniciar a depuração, clique em image::images/debug-main-project-button.png[]. O depurador para no ponto de interrupção.
-6. Pressione F7 três vezes. O depurador para na linha em que a função ``calculate_sum_of_factorials ()`` é chamada. A janela Variáveis Locais mostra as variáveis ``$m`` e ``$n`` com seus valores:
+
+[start=5]
+. Para iniciar a depuração, clique em image:images/debug-main-project-button.png[]. O depurador para no ponto de interrupção.
+
+[start=6]
+. Pressione F7 três vezes. O depurador para na linha em que a função ``calculate_sum_of_factorials ()`` é chamada. A janela Variáveis Locais mostra as variáveis ``$m`` e ``$n`` com seus valores:
+
image::images/degugger-stopped-at-function-call.png[]
-7. Para fazer step into na função ``calculate_sum_of_factorials()`` , pressione F7. O depurador começa a executar o código na função ``calculate_sum_of_factorials ()`` e para na chamada da função ``calculate_factorial()`` .
+
+
+[start=7]
+. Para fazer step into na função ``calculate_sum_of_factorials()`` , pressione F7. O depurador começa a executar o código na função ``calculate_sum_of_factorials ()`` e para na chamada da função ``calculate_factorial()`` .
+
image::images/call-of-embedded-function.png[]
+
A janela Variáveis Locais agora mostra as variáveis locais ``$argument1`` e ``$argument2`` declaradas na função ``calculate_sum_of_factorials ()`` .
+
image::images/variables-inside-function-call-another-function.png[]
-8. Pressione F7. O depurador começa a executar o código com a função ``calculate_factorial()`` . A janela Pilha de Chamadas mostra a pilha de chamadas para as funções na ordem inversa, com a última função chamada na parte superior da lista:
+
+
+[start=8]
+. Pressione F7. O depurador começa a executar o código com a função ``calculate_factorial()`` . A janela Pilha de Chamadas mostra a pilha de chamadas para as funções na ordem inversa, com a última função chamada na parte superior da lista:
+
image::images/call-stack.png[]
-9. Pressione F7 para fazer step into no loop. Exiba os valores das variáveis na janela Variáveis.
+
+
+[start=9]
+. Pressione F7 para fazer step into no loop. Exiba os valores das variáveis na janela Variáveis.
+
image::images/local-variables-inside-loop.png[]
-10. Quando você se certificar de que o código está funcionando corretamente, pressione Ctrl-F7/⌘-F7 para cancelar a execução da função. O programa retorna para a linha após a chamada da função ``calculate_factorial()`` .
-*Observação:* como alternativa, você pode pressionar F7, até que o programa conclua a execução da função ``calculate_factorial()`` . Você também retornará para a linha após essa chamada.
+
+
+[start=10]
+. Quando você se certificar de que o código está funcionando corretamente, pressione Ctrl-F7/⌘-F7 para cancelar a execução da função. O programa retorna para a linha após a chamada da função ``calculate_factorial()`` .
+
+NOTE: como alternativa, você pode pressionar F7, até que o programa conclua a execução da função ``calculate_factorial()`` . Você também retornará para a linha após essa chamada.
+
image::images/call-of-embedded-function-second-time.png[]
-11. Como você acabou de verificar a função ``calculate_factorial()`` e sabe que ela está funcionando corretamente, pode pular sua execução ("fazer step over"). Para fazer step over, pressione F8. O programa para na chamada da função ``calculate_sum()`` .
+
+
+[start=11]
+. Como você acabou de verificar a função ``calculate_factorial()`` e sabe que ela está funcionando corretamente, pode pular sua execução ("fazer step over"). Para fazer step over, pressione F8. O programa para na chamada da função ``calculate_sum()`` .
+
image::images/cal-of-embedded-function-calculate-sum.png[]
-12. Para fazer step into na função ``calculate_sum()`` , pressione F7.
-13. Para fazer step over, pressione F8. Em qualquer um dos casos, o depurador para na última linha na função ``calculate_sum_of_factorials()`` .
+
+
+[start=12]
+. Para fazer step into na função ``calculate_sum()`` , pressione F7.
+
+[start=13]
+. Para fazer step over, pressione F8. Em qualquer um dos casos, o depurador para na última linha na função ``calculate_sum_of_factorials()`` .
+
image::images/return-result.png[]
-14. Pressione F7. O depurador vai para a linha com a instrução ``echo`` .
-15. Pressione F7, até que o depurador saia do programa. A janela do browser será aberta e mostrará o resultado da execução do programa:
+
+
+[start=14]
+. Pressione F7. O depurador vai para a linha com a instrução ``echo`` .
+
+[start=15]
+. Pressione F7, até que o depurador saia do programa. A janela do browser será aberta e mostrará o resultado da execução do programa:
+
image::images/program-output.png[]
@@ -326,30 +388,38 @@ Você pode definir uma expressão do watch adicional para acompanhar a execuçã
1. Atualize o código como se segue (substitua um mais por um menos):
-[source,java]
+[source,php]
----
function calculate_sum ($argument1, $argument2) {return $argument1 - argument2;}
----
Imagine que isso tenha resultado de um erro de digitação, mas você na verdade precise calcular a soma.
-2. Selecione Depurar > Novo Watch ou pressione Ctrl/⌘-shift-F7. A Janela Novo Watch será Aberta.
-3. Digite a seguinte expressão e clique em OK.
-[source,java]
+[start=2]
+. Selecione Depurar > Novo Watch ou pressione Ctrl/⌘-shift-F7. A Janela Novo Watch será Aberta.
+
+[start=3]
+. Digite a seguinte expressão e clique em OK.
+
+[source,php]
----
$factorial1+$factorial2
----
A nova expressão aparece na janela Watches.
-4. Execute a sessão de depuração. Quando o depurador parar na linha
-[source,java]
+[start=4]
+. Execute a sessão de depuração. Quando o depurador parar na linha
+
+[source,php]
----
return $result;
----
compare o valor da expressão na janela Watches e o valor de $result na janela Variáveis Locais. Eles devem ser iguais, mas estão diferentes.
+
image::images/watches.png[]
+
Este exemplo é muito simples e deve dar uma noção geral do uso de watches.
@@ -367,24 +437,34 @@ Você pode depurar código que contenha blocos PHP e HTML. No exemplo da seção
Encontre mais informações sobre link:wish-list-lesson2.html#htmlForm[+forms de entrada HTML+].
-2. Substitua as seguintes linhas na parte superior do bloco <?php ?>:
-[source,java]
+[start=2]
+. Substitua as seguintes linhas na parte superior do bloco <?php ?>:
+
+[source,php]
----
$m=5;$n=10;$sum_of_factorials = calculate_sum_of_factorials ($m, $n);echo "The sum of factorials of the entered integers is " . $sum_of_factorials;
----
pelo seguinte código:
-[source,java]
+[source,php]
----
if (array_key_exists ("first_integer", $_POST) && array_key_exists ("second_integer", $_POST)) {$result = calculate_sum_of_factorials ($_POST["first_integer"], $_POST["second_integer"]);echo "Sum of factorials is " . $result;}
----
-3. Defina um ponto de interrupção no início do bloco <?php ?> e inicie a <<debuggingSession,sessão de depuração>>.
-4. Pressione F7. O depurador entra no programa. A janela do browser é aberta mas o form de entrada não é exibido. Esse é o comportamento correto do depurador, porque ele tem que entrar em todo o código-fonte de uma página web, antes que a página possa ser exibida. Praticamente, isso significa que o depurador entra no código duas vezes. Na primeira vez, o depurador processa o código para exibir o form de entrada de HTML. Na segunda vez, o depurador executa o código PHP passo a passo.
-5. Pressione F7, até que o depurador alcance o final do programa e o form de entrada seja aberto.
-6. Preencha o form e clique em Enter. A sessão de depuração continua conforme descrito na seção <<sampleDebuggingSession,Sessão de Depuração de Amostra>>.
+
+[start=3]
+. Defina um ponto de interrupção no início do bloco <?php ?> e inicie a <<debuggingSession,sessão de depuração>>.
+
+[start=4]
+. Pressione F7. O depurador entra no programa. A janela do browser é aberta mas o form de entrada não é exibido. Esse é o comportamento correto do depurador, porque ele tem que entrar em todo o código-fonte de uma página web, antes que a página possa ser exibida. Praticamente, isso significa que o depurador entra no código duas vezes. Na primeira vez, o depurador processa o código para exibir o form de entrada de HTML. Na segunda vez, o depurador executa o código PHP passo a passo.
+
+[start=5]
+. Pressione F7, até que o depurador alcance o final do programa e o form de entrada seja aberto.
+
+[start=6]
+. Preencha o form e clique em Enter. A sessão de depuração continua conforme descrito na seção <<sampleDebuggingSession,Sessão de Depuração de Amostra>>.
== [[ Mapeamento de Caminho, Proxy do Depurador e Iniciando uma Sessão de Depuração em um URL Personalizado]]
@@ -401,7 +481,9 @@ if (array_key_exists ("first_integer", $_POST) && array_key_exists ("sec
* Perguntar Todas as Vezes, que faz com que o IDE solicite o URL quando você inicia uma sessão de depuração.
* Não Abrir o Web Browser, que requer que você abra o browser e insira manualmente o URL (é preciso ter a variável GET/POST XDEBUG_SESSION_START).
-6. Se você estiver usando um servidor proxy para a depuração, digite o nome do host e a porta do servidor na seção Proxy do Depurador.
+
+[start=6]
+. Se você estiver usando um servidor proxy para a depuração, digite o nome do host e a porta do servidor na seção Proxy do Depurador.
Para obter mais informações, consulte o post link:http://blogs.oracle.com/netbeansphp/entry/path_mapping_in_php_debugger[+Mapeamento do Caminho no Depurador PHP+] no blog Net Beans para o PHP.
diff --git a/netbeans.apache.org/src/content/kb/docs/php/debugging_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/debugging_ru.asciidoc
index 592142b..19609b4 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/debugging_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/debugging_ru.asciidoc
@@ -30,9 +30,6 @@
:keywords: Apache NetBeans, Tutorials, Отладка исходного кода PHP в IDE NetBeans
-image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой страницы применимо к IDE NetBeans 7.2, 7.3, 7.4 и 8.0"]
-
-
*Для работы с этим учебным курсом требуется следующее программное обеспечение и ресурсы.*
|===
@@ -72,7 +69,7 @@ IDE NetBeans обеспечивает панель инструментов от
Параметры IDE NetBeans включают вкладку для изменения определенных настроек по умолчанию для отладки PHP. Чтобы открыть эти параметры, зайдите в Tools ("Средства") > Options ("Параметры") (NetBeans > Preferences ("Настройки") на Mac), выберите параметры PHP, после чего выберите вкладку Debugging ("Отладка").
-*Примечание *. Вкладка 'Отладка' была реализована в IDE NetBeans версии 7.1. В более ранних версиях NetBeans на вкладке 'Общие' PHP имеются параметры отладки. Не все параметры версии 7.1 доступны в предыдущих версиях.
+NOTE: . Вкладка 'Отладка' была реализована в IDE NetBeans версии 7.1. В более ранних версиях NetBeans на вкладке 'Общие' PHP имеются параметры отладки. Не все параметры версии 7.1 доступны в предыдущих версиях.
image::images/php-debugging-options.png[]
@@ -87,7 +84,7 @@ image::images/php-debugging-options.png[]
* *Показывать запрошенные URL-адреса.* Открывается новое окно вывода при отладке. Это окно вывода называется PHP Requested Urls ("URL-адреса, запрошенные PHP") и отображает URL-адреса, обрабатываемые в настоящий момент. URL-адреса можно щелкать. Щелкните URL-адрес в окне вывода, чтобы открыть этот URL-адрес в окне браузера.
* *Консоль отладчика PHP.* Открывается новое окно вывода, в котором показан результат сценариев отладки.
-*Примечание.* Задайте ``output_buffering = Off`` в используемом файле ``php.ini`` . иначе выводы сценариев будут появляться в окне вывода с задержкой.
+NOTE: Задайте ``output_buffering = Off`` в используемом файле ``php.ini`` . иначе выводы сценариев будут появляться в окне вывода с задержкой.
В рамках данного учебного курса нет необходимости менять любые из этих параметров. При желании это можно сделать для включения точек наблюдения.
@@ -111,19 +108,19 @@ image::images/debugger-toolbar2.png[title="Панель инструментов
Панель инструментов предоставляет возможности выполнения следующих действий:
|===
-|*Завершить сеанс* ( image::images/finish-session-button.png[] ) |Завершение сеанса отладки
+|*Завершить сеанс* ( image:images/finish-session-button.png[] ) |Завершение сеанса отладки
-|*Приостановить* ( image::images/pause-button.png[] ) |Приостановка сеанса отладки
+|*Приостановить* ( image:images/pause-button.png[] ) |Приостановка сеанса отладки
-|*Возобновить* ( image::images/resume-button.png[] ) |Возобновление сеанса отладки
+|*Возобновить* ( image:images/resume-button.png[] ) |Возобновление сеанса отладки
-|*Обход процедур* ( image::images/step-over-button.png[] ) |Переход к следующему оператору выполнения
+|*Обход процедур* ( image:images/step-over-button.png[] ) |Переход к следующему оператору выполнения
-|*Вход в* ( image::images/step-into-button.png[] ) |Переход к вызову функции
+|*Вход в* ( image:images/step-into-button.png[] ) |Переход к вызову функции
-|*Выходt* ( image::images/step-out-button.png[] ) |Выход из текущего состояния вызова функции
+|*Выходt* ( image:images/step-out-button.png[] ) |Выход из текущего состояния вызова функции
-|*Переход к курсору* ( image::images/run-to-cursor-button.png[] ) |Запуск выполнения с позиции курсора
+|*Переход к курсору* ( image:images/run-to-cursor-button.png[] ) |Запуск выполнения с позиции курсора
|===
@@ -139,9 +136,9 @@ image::images/debugger-toolbar2.png[title="Панель инструментов
image::images/set-breakpoint.png[title="Точка останова может быть задана в редакторе"]
-Чтобы удалить точку останова, щелкните маркер точки останова ( image::images/breakpoint-badge.png[] ).
+Чтобы удалить точку останова, щелкните маркер точки останова ( image:images/breakpoint-badge.png[] ).
-Также можно временно отключить точки останова. Для этого щелкните правой кнопкой мыши значок точки останова и снимите выделение с 'Точка останова' > ✔'Включено'. Выполняется переключение точки останова в отключенное состояние, после чего маркер выделяется серым ( image::images/disabled-breakpoint-badge.png[] ) и отображается на левом поле.
+Также можно временно отключить точки останова. Для этого щелкните правой кнопкой мыши значок точки останова и снимите выделение с 'Точка останова' > ✔'Включено'. Выполняется переключение точки останова в отключенное состояние, после чего маркер выделяется серым ( image:images/disabled-breakpoint-badge.png[] ) и отображается на левом поле.
Если отладчик во время работы достигает точки останова, отладка приостанавливается, что позволяет просмотреть значения в окнах отладки и перейти к любому месту кода после точки останова.
@@ -182,9 +179,9 @@ IDE NetBeans также позволяет запускать одновреме
image::images/sessions-win2.png[]
-Текущий сеанс (т.е. сеанс, которым можно управлять с помощью панели инструментов отладчика) отмечен более заметным значком ( image::images/current-session-icon.png[] ). Для переключения сеансов дважды щелкните сеанс, который необходимо сделать текущим или щелкните правой кнопкой мыши сеанс, который не является текущим и выберите 'Сделать текущим'.
+Текущий сеанс (т.е. сеанс, которым можно управлять с помощью панели инструментов отладчика) отмечен более заметным значком ( image:images/current-session-icon.png[] ). Для переключения сеансов дважды щелкните сеанс, который необходимо сделать текущим или щелкните правой кнопкой мыши сеанс, который не является текущим и выберите 'Сделать текущим'.
-*Примечание. *Рекомендуется воспользоваться переключением сеансов, если текущий сеанс отложен.
+NOTE: Рекомендуется воспользоваться переключением сеансов, если текущий сеанс отложен.
Также можно щелкнуть правой кнопкой мыши всплывающее окно для завершения сеанса (щелкните правой кнопкой мыши и выберите 'Завершить') или переключитесь между отладкой текущего потока или всех потоков в сеансе (щелкните правой кнопкой мыши и выберите 'Область' > 'Отладка всех потоков' или 'Отладка текущего потока').
@@ -244,26 +241,51 @@ image::images/breakpoints-win.png[]
1. Запустите среду IDE и откройте файл, содержащий исходный код, который необходимо отладить.
2. Установите точку останова в каждой строке, где отладчику следует приостановить работу. Для установки точки останова, поместите курсор в начало строки и нажмите Ctrl-F8 / ⌘-F8 или выберите 'Отладка' > 'Переключение точек останова на строке'
3. В окне 'Проекты' перейдите к узлу текущего проекта, щелкните правой кнопкой мыши и выберите 'Отладка' во всплывающем меню. Среда IDE открывает окна отладки и выполняет проект в отладчике до достижения установленной точки останова.
-*Примечание.* Если текущий проект настроен как 'Главный' выберите 'Отладка' > 'Отладка главного проекта' или нажмите Ctrl-F5, или щелкните image::images/debug-main-project-button.png[].
-4. Перейдите в окно "Local Variables". В данном окне показаны все переменные, которые инициализированы внутри текущей функции, их типы и их значения.
-5. Для просмотра значения переменной отдельно от функции переместите курсор на отображаемую переменную. Подсказка показывает значение переменной.
-6. Для построчного выполнения программы (включая строки внутри всех вызванных функций) нажмите F7 или выберите "Debug > StepInto" и наблюдайте за изменениями значений переменных в окне "Локальные переменные".
-7. Для проверки логики программы путем наблюдения за изменениями выражений определите новый параметр наблюдения:
-1. Для открытия окна "Watches " выберите путь "Window > Debugging > Watches" или нажмите сочетание клавиш Ctrl-Shift-2. Откроется окно "Watches".
-2. Щелкните окно "Watches" правой кнопкой мыши и выберите "New Watch" во всплывающем меню. Откроется окно "New Watch".
-3. Введите наблюдаемое выражение и нажмите OK.
+NOTE: Если текущий проект настроен как 'Главный' выберите 'Отладка' > 'Отладка главного проекта' или нажмите Ctrl-F5, или щелкните image:images/debug-main-project-button.png[].
+
+[start=4]
+. Перейдите в окно "Local Variables". В данном окне показаны все переменные, которые инициализированы внутри текущей функции, их типы и их значения.
+
+[start=5]
+. Для просмотра значения переменной отдельно от функции переместите курсор на отображаемую переменную. Подсказка показывает значение переменной.
+
+[start=6]
+. Для построчного выполнения программы (включая строки внутри всех вызванных функций) нажмите F7 или выберите "Debug > StepInto" и наблюдайте за изменениями значений переменных в окне "Локальные переменные".
+
+[start=7]
+. Для проверки логики программы путем наблюдения за изменениями выражений определите новый параметр наблюдения:
+.. Для открытия окна "Watches " выберите путь "Window > Debugging > Watches" или нажмите сочетание клавиш Ctrl-Shift-2. Откроется окно "Watches".
+.. Щелкните окно "Watches" правой кнопкой мыши и выберите "New Watch" во всплывающем меню. Откроется окно "New Watch".
+.. Введите наблюдаемое выражение и нажмите OK.
Теперь в течение отладки можно выполнить дополнительную проверку.
*Важно!* Для установки точек наблюдения необходимо включить точки наблюдения на <<options,вкладке Debugging ("Отладка") параметров PHP>>.
-8. Для пропуска построчного выполнения кода в функции получите возвращенное этой функцией значение, перейдите к следующей строке после вызова функции и нажмите F8 или выберите "Debug > Step Over".
-9. Для пропуска построчного выполнения кода в функции получите возвращенное этой функцией значение, перейдите к следующей строке после вызова функции и нажмите F8 или выберите "Debug > Step Over".
-10. Для приостановки сеанса отладки выберите "Debug > Pause".
-11. Для продолжения сеанса отладки выберите "Debug > Continue".image::images/continue-debugging-session.png[].
-12. Для отмены сеанса отладки нажмите image::images/stop-debugging-session.png[].
-13.
-После завершения программы окна отладки закрываются.
+
+[start=8]
+. Для пропуска построчного выполнения кода в функции получите возвращенное этой функцией значение, перейдите к следующей строке после вызова функции и нажмите F8 или выберите "Debug > Step Over".
+
+[start=9]
+. Для пропуска построчного выполнения кода в функции получите возвращенное этой функцией значение, перейдите к следующей строке после вызова функции и нажмите F8 или выберите "Debug > Step Over".
+
+[start=10]
+. Для приостановки сеанса отладки выберите "Debug > Pause".
+
+[start=11]
+. Для продолжения сеанса отладки выберите "Debug > Continue".
+
+image::images/continue-debugging-session.png[].
+
+
+[start=12]
+. Для отмены сеанса отладки нажмите
+
+image::images/stop-debugging-session.png[].
+
+
+[start=13]
+. После завершения программы окна отладки закрываются.
== Пример сеанса отладки
@@ -275,8 +297,12 @@ image::images/breakpoints-win.png[]
* Расположение исходных файлов – по умолчанию папка ``htdocs``
* Настройка выполнения – локальный веб-сайт
Для получения более подробной информации о настройке проекта PHP см. link:project-setup.html[+Настройка проекта PHP+].
-2. Для активации возможности использования "горячих" клавиш во время сеанса установите курсор на узел проекта и выберите "Set as Main Project" во всплывающем меню.
-3. Введите следующий код в файле ``index.php`` :
+
+[start=2]
+. Для активации возможности использования "горячих" клавиш во время сеанса установите курсор на узел проекта и выберите "Set as Main Project" во всплывающем меню.
+
+[start=3]
+. Введите следующий код в файле ``index.php`` :
[source,php]
----
@@ -287,34 +313,76 @@ image::images/breakpoints-win.png[]
* функция ``calculate_factorial ()`` ;
* функция ``calcualte_sum ()`` ;
* функция ``calculate_sum_of_factorials ()`` (дважды вызывает функцию ``calculate_factorial`` , затем однократно вызывает функцию ``calcualte_sum ()`` и возвращает рассчитанную сумму факториалов).
-4. Задайте точку останова (Ctrl-F8/⌘-F8) в начале блока PHP:
+
+[start=4]
+. Задайте точку останова (Ctrl-F8/⌘-F8) в начале блока PHP:
[source,php]
----
<?php
----
-5. Для начала отладка щелкните image::images/debug-main-project-button.png[]. Отладчик остановится по достижении точки останова.
-6. Нажмите F7 три раза. Отладчик остановится в той строке, в которой вызывается функция ``calculate_sum_of_factorials ()`` . В окне "Local Variables" отображаются переменные ``$m`` и ``$n`` с соответствующими значениями:
+
+[start=5]
+. Для начала отладка щелкните image:images/debug-main-project-button.png[]. Отладчик остановится по достижении точки останова.
+
+[start=6]
+. Нажмите F7 три раза. Отладчик остановится в той строке, в которой вызывается функция ``calculate_sum_of_factorials ()`` . В окне "Local Variables" отображаются переменные ``$m`` и ``$n`` с соответствующими значениями:
+
image::images/degugger-stopped-at-function-call.png[]
-7. Нажмите F7 для перехода к функции ``calculate_sum_of_factorials()`` . Отладчик начнет выполнение кода внутри функции ``calculate_sum_of_factorials ()`` и остановится при вызове функции ``calculate_factorial()`` .
+
+
+[start=7]
+. Нажмите F7 для перехода к функции ``calculate_sum_of_factorials()`` . Отладчик начнет выполнение кода внутри функции ``calculate_sum_of_factorials ()`` и остановится при вызове функции ``calculate_factorial()`` .
+
image::images/call-of-embedded-function.png[]
+
Теперь в окне "Local Variables" отображаются локальные переменные ``$argument1`` и ``$argument2`` , заявленные в функции ``calculate_sum_of_factorials ()`` .
+
image::images/variables-inside-function-call-another-function.png[]
-8. Нажмите F7. Отладчик начнет выполнение кода с функцией ``calculate_factorial()`` . В окне "Call Stack" отображается стек вызовов функций в обратном порядке, начиная с последней вызванной функции:
+
+
+[start=8]
+. Нажмите F7. Отладчик начнет выполнение кода с функцией ``calculate_factorial()`` . В окне "Call Stack" отображается стек вызовов функций в обратном порядке, начиная с последней вызванной функции:
+
image::images/call-stack.png[]
-9. Нажмите F7 для перехода к циклу. Просмотрите значения переменных в окне Variables ("Переменные").
+
+
+[start=9]
+. Нажмите F7 для перехода к циклу. Просмотрите значения переменных в окне Variables ("Переменные").
+
image::images/local-variables-inside-loop.png[]
-10. После подтверждения правильности работы кода нажмите Ctrl-F7/⌘-F7, чтобы отменить выполнение функции. Затем будет выполнен возврат к строке, следующей после строки вызова функции ``calculate_factorial()`` .
-*Примечание.* В качестве альтернативы можно нажимать F7 до завершения программой выполнения функции ``calculate_factorial()`` . После вызова этой функции также будет выполнен возврат к следующей строке.
+
+
+[start=10]
+. После подтверждения правильности работы кода нажмите Ctrl-F7/⌘-F7, чтобы отменить выполнение функции. Затем будет выполнен возврат к строке, следующей после строки вызова функции ``calculate_factorial()`` .
+
+NOTE: В качестве альтернативы можно нажимать F7 до завершения программой выполнения функции ``calculate_factorial()`` . После вызова этой функции также будет выполнен возврат к следующей строке.
+
image::images/call-of-embedded-function-second-time.png[]
-11. Поскольку проверка функции ``calculate_factorial()`` была только что выполнена, и известно, что функция работает нормально, ее выполнение можно "пропустить". Для этого нажмите F8. Программа завершит работу при вызове функции ``calculate_sum()`` .
+
+
+[start=11]
+. Поскольку проверка функции ``calculate_factorial()`` была только что выполнена, и известно, что функция работает нормально, ее выполнение можно "пропустить". Для этого нажмите F8. Программа завершит работу при вызове функции ``calculate_sum()`` .
+
image::images/cal-of-embedded-function-calculate-sum.png[]
-12. Для перехода к функции ``calculate_sum()`` нажмите F7.
-13. Для этого нажмите F8. В любом случае отладчик остановится на последней строке в функции ``calculate_sum_of_factorials()`` .
+
+
+[start=12]
+. Для перехода к функции ``calculate_sum()`` нажмите F7.
+
+[start=13]
+. Для этого нажмите F8. В любом случае отладчик остановится на последней строке в функции ``calculate_sum_of_factorials()`` .
+
image::images/return-result.png[]
-14. Нажмите F7. Отладчик переместится к строке с оператором ``echo`` .
-15. Нажимайте F7 до тех пор, пока отладчик не завершит работу с программой. Откроется окно браузера, в котором отображается результат выполнения программы:
+
+
+[start=14]
+. Нажмите F7. Отладчик переместится к строке с оператором ``echo`` .
+
+[start=15]
+. Нажимайте F7 до тех пор, пока отладчик не завершит работу с программой. Откроется окно браузера, в котором отображается результат выполнения программы:
+
image::images/program-output.png[]
@@ -326,30 +394,38 @@ image::images/program-output.png[]
1. Обновите код, как показано ниже (замените знак "плюс" на знак "минус"):
-[source,java]
+[source,php]
----
function calculate_sum ($argument1, $argument2) {return $argument1 - argument2;}
----
Можно предположить, что это следствие неправильного написания кода, но фактически требуется еще раз подсчитать сумму.
-2. Выберите 'Отладка' > 'Создать наблюдение' или нажмите Ctrl/⌘-shift-F7. Откроется окно "New Watch".
-3. Введите следующее выражение и нажмите "ОК".
-[source,java]
+[start=2]
+. Выберите 'Отладка' > 'Создать наблюдение' или нажмите Ctrl/⌘-shift-F7. Откроется окно "New Watch".
+
+[start=3]
+. Введите следующее выражение и нажмите "ОК".
+
+[source,php]
----
$factorial1+$factorial2
----
Новое выражение появится в окне "Watches".
-4. Запустите сеанс отладки. После остановки отладчика остановится в указанной строке:
-[source,java]
+[start=4]
+. Запустите сеанс отладки. После остановки отладчика остановится в указанной строке:
+
+[source,php]
----
return $result;
----
сравните значение выражения в окне "Watches" со значением $result в окне "Local Variables". Эти значения должны совпадать, но они различны.
+
image::images/watches.png[]
+
Этот пример является простым, однако позволяет получить некоторое представление об использовании наблюдаемых выражений.
@@ -367,24 +443,34 @@ image::images/watches.png[]
Дополнительная информация о link:wish-list-lesson2.html#htmlForm[+формах ввода HTML+].
-2. Замените следующие строки в верхней части блока <? php? >:
-[source,java]
+[start=2]
+. Замените следующие строки в верхней части блока <? php? >:
+
+[source,php]
----
$m=5;$n=10;$sum_of_factorials = calculate_sum_of_factorials ($m, $n);echo "The sum of factorials of the entered integers is " . $sum_of_factorials;
----
на следующий код:
-[source,java]
+[source,php]
----
if (array_key_exists ("first_integer", $_POST) && array_key_exists ("second_integer", $_POST)) {$result = calculate_sum_of_factorials ($_POST["first_integer"], $_POST["second_integer"]);echo "Sum of factorials is " . $result;}
----
-3. Установите точку останова в начале блока <? php? > и начните <<debuggingSession,сеанс отладки>>.
-4. Нажмите F7. Отладчик перейдет к программе. Откроется окно браузера, но форма ввода в нем не отображается. Это нормальный режим работы отладчика, поскольку для отображения веб-страницы отладчик должен пройти по всему исходному коду. Фактически это означает, что отладчик обрабатывает код дважды. Первый раз обрабатывается код для отображения формы ввода HTML. Второй раз поэтапно обрабатывается код PHP.
-5. Нажимайте F7 до тех пор, пока не будет достигнут конец программы; после этого откроется форма ввода.
-6. Заполните форму и нажмите Enter. Сеанс отладки будет продолжен, как описано в разделе <<sampleDebuggingSession,Пример сеанса отладки>>.
+
+[start=3]
+. Установите точку останова в начале блока <? php? > и начните <<debuggingSession,сеанс отладки>>.
+
+[start=4]
+. Нажмите F7. Отладчик перейдет к программе. Откроется окно браузера, но форма ввода в нем не отображается. Это нормальный режим работы отладчика, поскольку для отображения веб-страницы отладчик должен пройти по всему исходному коду. Фактически это означает, что отладчик обрабатывает код дважды. Первый раз обрабатывается код для отображения формы ввода HTML. Второй раз поэтапно обрабатывается код PHP.
+
+[start=5]
+. Нажимайте F7 до тех пор, пока не будет достигнут конец программы; после этого откроется форма ввода.
+
+[start=6]
+. Заполните форму и нажмите Enter. Сеанс отладки будет продолжен, как описано в разделе <<sampleDebuggingSession,Пример сеанса отладки>>.
== [[Отображение пути, прокси отладчика и запуск сеанса отладки по пользовательскому URL-адресу]]
@@ -401,7 +487,9 @@ if (array_key_exists ("first_integer", $_POST) && array_key_exists ("sec
* Ask Every Time ("Спрашивать каждый раз"), указывающий среде IDE запрашивать URL-адрес у пользователя при каждом запуске сеанса отладки.
* Do Not Open Web Browser ("Не открывать веб-браузер"), в результате чего придется открыть браузер и ввести URL-адрес вручную (будет необходима переменная GET/POST XDEBUG_SESSION_START).
-6. В случае использования для отладки прокси-сервера введите имя узла и порт сервера в разделе Debugger Proxy ("Прокси отладчика").
+
+[start=6]
+. В случае использования для отладки прокси-сервера введите имя узла и порт сервера в разделе Debugger Proxy ("Прокси отладчика").
Дополнительные сведения приведены в записи link:http://blogs.oracle.com/netbeansphp/entry/path_mapping_in_php_debugger[+Path Mapping in PHP Debugger ("Сопоставление путей в отладчике PHP")+] блога по Net Beans для PHP.
diff --git a/netbeans.apache.org/src/content/kb/docs/php/debugging_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/debugging_zh_CN.asciidoc
index a29f77a..3a2a8de 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/debugging_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/debugging_zh_CN.asciidoc
@@ -30,9 +30,6 @@
:keywords: Apache NetBeans, Tutorials, 在 NetBeans IDE 中调试 PHP 源代码
-image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 NetBeans IDE 7.2、7.3、7.4 和 8.0"]
-
-
*要学习本教程，您需要具备以下软件和资源。*
|===
@@ -72,7 +69,7 @@ NetBeans IDE 提供了一个调试工具栏，可帮助您逐步执行文件。
NetBeans IDE 的 "Options"（选项）中包含一个标签，用于更改 PHP 调试的某些默认设置。要打开这些选项，请转至 "Tools"（工具）> "Options"（选项）（在 Mac 上则转至 "NetBeans" > "Preferences"（首选项）），然后依次选择 "PHP" 选项和 "Debugging"（调试）标签。
-*注：*在 NetBeans IDE 版本 7.1 中引入了 "Debugging"（调试）标签。早期版本的 NetBeans 在 "General PHP"（常规 PHP）标签中具有调试选项。版本 7.1 中的部分选项在早期版本中不可用。
+NOTE: 在 NetBeans IDE 版本 7.1 中引入了 "Debugging"（调试）标签。早期版本的 NetBeans 在 "General PHP"（常规 PHP）标签中具有调试选项。版本 7.1 中的部分选项在早期版本中不可用。
image::images/php-debugging-options.png[]
@@ -87,7 +84,7 @@ image::images/php-debugging-options.png[]
* *Show Requested URLs（显示请求的 URL）。*调试期间打开新的 "Output"（输出）窗口。此 "Output"（输出）窗口名为 "PHP Requested Urls"（PHP 请求的 URL），它会显示当前处理的 URL。这些 URL 是可单击的。在 "Output"（输出）窗口中单击 URL，以便在浏览器窗口中打开该 URL。
* *PHP Debugger Console（PHP 调试器控制台）。*打开显示已调试脚本输出的新 "Output"（输出）窗口。
-*注：*请设置 ``php.ini`` 文件中的 ``output_buffering = Off`` 。否则，在 "Output"（输出）窗口中，将会延迟显示脚本输出。
+NOTE: 请设置 ``php.ini`` 文件中的 ``output_buffering = Off`` 。否则，在 "Output"（输出）窗口中，将会延迟显示脚本输出。
就本教程而言，您不需要更改任何这些设置，除非选择性地启用监视。
@@ -111,19 +108,19 @@ image::images/debugger-toolbar2.png[title="处于挂起状态的调试器工具
工具栏提供了以下操作：
|===
-|*完成会话* (image::images/finish-session-button.png[]) |完成调试会话
+|*完成会话* (image:images/finish-session-button.png[]) |完成调试会话
-|*暂停* (image::images/pause-button.png[]) |挂起调试会话
+|*暂停* (image:images/pause-button.png[]) |挂起调试会话
-|*恢复* (image::images/resume-button.png[]) |继续调试会话
+|*恢复* (image:images/resume-button.png[]) |继续调试会话
-|*步过* (image::images/step-over-button.png[]) |越过执行语句
+|*步过* (image:images/step-over-button.png[]) |越过执行语句
-|*步入* (image::images/step-into-button.png[]) |步入函数调用
+|*步入* (image:images/step-into-button.png[]) |步入函数调用
-|*步出* (image::images/step-out-button.png[]) |步出当前函数调用
+|*步出* (image:images/step-out-button.png[]) |步出当前函数调用
-|*运行至光标位置* (image::images/run-to-cursor-button.png[]) |运行至光标位置
+|*运行至光标位置* (image:images/run-to-cursor-button.png[]) |运行至光标位置
|===
@@ -139,9 +136,9 @@ image::images/debugger-toolbar2.png[title="处于挂起状态的调试器工具
image::images/set-breakpoint.png[title="可在编辑器中设置断点"]
-可以通过单击断点标记 (image::images/breakpoint-badge.png[]) 删除断点。
+可以通过单击断点标记 (image:images/breakpoint-badge.png[]) 删除断点。
-此外，还可以暂时禁用断点。要执行此操作，请右键单击断点标记，然后取消选中 "Breakpoint"（断点）> "✔Enabled"（✔启用）。这会将断点切换为禁用状态，从而导致一个灰色标记 (image::images/disabled-breakpoint-badge.png[]) 显示在左旁注中。
+此外，还可以暂时禁用断点。要执行此操作，请右键单击断点标记，然后取消选中 "Breakpoint"（断点）> "✔Enabled"（✔启用）。这会将断点切换为禁用状态，从而导致一个灰色标记 (image:images/disabled-breakpoint-badge.png[]) 显示在左旁注中。
如果调试器在执行时遇到断点，它将在断点处停止，以便您在调试窗口中检查变量，然后逐步执行断点后面的任何代码。
@@ -182,9 +179,9 @@ NetBeans IDE 还允许同时运行多个调试器会话。例如，可以同时
image::images/sessions-win2.png[]
-当前会话（即您可使用调试器工具栏控制的会话）由更为醒目的图标 (image::images/current-session-icon.png[]) 指示。要切换会话，您可以双击要激活的会话，或者右键单击非当前会话，然后选择“激活”。
+当前会话（即您可使用调试器工具栏控制的会话）由更为醒目的图标 (image:images/current-session-icon.png[]) 指示。要切换会话，您可以双击要激活的会话，或者右键单击非当前会话，然后选择“激活”。
-*注：*如果挂起了当前所在的会话，建议您不要切换会话。
+NOTE: 如果挂起了当前所在的会话，建议您不要切换会话。
您还可以使用右键单击弹出式窗口终止会话（单击鼠标右键，然后选择 "Finish"（完成）），或者在调试会话中的当前线程或调试所有线程之间切换（单击鼠标右键，然后选择 "Scope"（范围）> "Debug All Threads"（调试所有线程）或 "Debug Current Thread"（调试当前线程））。
@@ -244,26 +241,45 @@ image::images/breakpoints-win.png[]
1. 启动 IDE，然后打开包含要调试的源代码的文件。
2. 在要暂停调试器的每行设置断点。要设置断点，请将光标放在行首，然后按 Ctrl-F8/⌘-F8 组合键，或者选择 "Debug"（调试）> "Toggle Line Breakpoint"（开启/关闭行断点）。
3. 在 "Projects"（项目）窗口中，导航至当前项目节点，单击鼠标右键，然后从弹出式菜单中选择 "Debug"（调试）。IDE 将打开调试器窗口并在调试器中运行该项目，直至到达断点为止。
-*注：*如果当前项目设置为“主项目”，您可以选择“调试”>“调试主项目”，按 Ctrl-F5，或单击 image::images/debug-main-project-button.png[]。
-4. 切换至 "Local Variables"（局部变量）窗口。该窗口显示当前函数中已初始化的所有变量及其类型和值。
-5. 要查看该函数外部的变量值，请将光标置于此变量出现的某个位置上。工具提示会显示变量值。
-6. 要逐行（包括所有被调用函数中的行）执行程序，请按 F7 键或选择 "Debug"（调试）> "Step Into"（步入），然后在 "Local Variables"（局部变量）窗口中监视这些变量值的更改。
-7. 要通过监视表达式的更改来检查程序逻辑，请定义一个新监视：
-1. 要打开 "Watches"（监视）窗口，请选择 "Window"（窗口）> "Debugging"（调试）> "Watches"（监视），或者按 Ctrl-Shift-2 组合键。"Watches"（监视）窗口打开。
-2. 在 "Watches"（监视）窗口中的任意位置单击鼠标右键，然后从弹出式菜单中选择 "New Watch"（新建监视）。"New Watch"（新建监视）窗口打开。
-3. 输入监视表达式，然后单击 "OK"（确定）。
+NOTE: 如果当前项目设置为“主项目”，您可以选择“调试”>“调试主项目”，按 Ctrl-F5，或单击 image:images/debug-main-project-button.png[]。
+
+[start=4]
+. 切换至 "Local Variables"（局部变量）窗口。该窗口显示当前函数中已初始化的所有变量及其类型和值。
+
+[start=5]
+. 要查看该函数外部的变量值，请将光标置于此变量出现的某个位置上。工具提示会显示变量值。
+
+[start=6]
+. 要逐行（包括所有被调用函数中的行）执行程序，请按 F7 键或选择 "Debug"（调试）> "Step Into"（步入），然后在 "Local Variables"（局部变量）窗口中监视这些变量值的更改。
+
+[start=7]
+. 要通过监视表达式的更改来检查程序逻辑，请定义一个新监视：
+.. 要打开 "Watches"（监视）窗口，请选择 "Window"（窗口）> "Debugging"（调试）> "Watches"（监视），或者按 Ctrl-Shift-2 组合键。"Watches"（监视）窗口打开。
+.. 在 "Watches"（监视）窗口中的任意位置单击鼠标右键，然后从弹出式菜单中选择 "New Watch"（新建监视）。"New Watch"（新建监视）窗口打开。
+.. 输入监视表达式，然后单击 "OK"（确定）。
现在，您便可以在调试过程中进行其他检查。
*重要提示：*您必须在 <<options,PHP "Options"（选项）的 "Debugging"（调试）标签>>中启用监视才能设置监视。
-8. 要取消对某个函数中代码的逐行执行操作并跳至该函数调用后的下一行，请按 Ctrl-F7/⌘-F7 组合键或选择 "Debug"（调试）> "Step Out"（步出）。
-9. 要跳过对某个函数中代码的逐行执行操作，获取该函数返回的值，并跳至该函数调用后的下一行，请按 F8 键或选择 "Debug"（调试）> "Step Over"（步过）。
-10. 要暂停调试会话，请选择 "Debug"（调试）> "Pause"（暂停）。
-11. 要继续调试会话，请选择 "Debug"（调试）> "Continue"（继续）或按 image::images/continue-debugging-session.png[]。
-12. 要取消调试会话，请按 image::images/stop-debugging-session.png[]。
-13.
-在程序结束时，调试器窗口会关闭。
+
+[start=8]
+. 要取消对某个函数中代码的逐行执行操作并跳至该函数调用后的下一行，请按 Ctrl-F7/⌘-F7 组合键或选择 "Debug"（调试）> "Step Out"（步出）。
+
+[start=9]
+. 要跳过对某个函数中代码的逐行执行操作，获取该函数返回的值，并跳至该函数调用后的下一行，请按 F8 键或选择 "Debug"（调试）> "Step Over"（步过）。
+
+[start=10]
+. 要暂停调试会话，请选择 "Debug"（调试）> "Pause"（暂停）。
+
+[start=11]
+. 要继续调试会话，请选择 "Debug"（调试）> "Continue"（继续）或按 image:images/continue-debugging-session.png[]。
+
+[start=12]
+. 要取消调试会话，请按 image:images/stop-debugging-session.png[]。
+
+[start=13]
+. 在程序结束时，调试器窗口会关闭。
== 样例调试会话
@@ -275,8 +291,12 @@ image::images/breakpoints-win.png[]
* 源位置 - ``htdocs`` 文件夹的默认位置
* 运行配置 - "Local Web Site"（本地 Web 站点）
有关设置 PHP 项目的更多详细信息，请参见link:project-setup.html[+设置 PHP 项目+]文档。
-2. 要在会话过程中使用热键，请将光标置于项目节点上，然后从弹出式菜单中选择 "Set as Main Project"（设置为主项目）。
-3. 在 ``index.php`` 文件中，输入以下代码：
+
+[start=2]
+. 要在会话过程中使用热键，请将光标置于项目节点上，然后从弹出式菜单中选择 "Set as Main Project"（设置为主项目）。
+
+[start=3]
+. 在 ``index.php`` 文件中，输入以下代码：
[source,php]
----
@@ -287,34 +307,75 @@ image::images/breakpoints-win.png[]
* ``calculate_factorial ()`` 函数
* ``calcualte_sum ()`` 函数
* ``calculate_sum_of_factorials ()`` 函数，该函数调用 ``calculate_factorial ()`` 函数两次，再调用 ``calcualte_sum ()`` 函数一次，然后返回计算的阶乘和。
-4. 在 PHP 块的开头设置一个断点（Ctrl-F8/⌘-F8 组合键）：
+
+[start=4]
+. 在 PHP 块的开头设置一个断点（Ctrl-F8/⌘-F8 组合键）：
[source,php]
----
<?php
----
-5. 要开始调试，请单击 image::images/debug-main-project-button.png[]。调试器将在断点处停止。
-6. 按 F7 键三次。调试器将在调用函数 ``calculate_sum_of_factorials ()`` 的行上停止。"Local Variables"（局部变量）窗口会显示变量 ``$m`` 和 ``$n`` 以及它们的值：
+
+[start=5]
+. 要开始调试，请单击 image:images/debug-main-project-button.png[]。调试器将在断点处停止。
+
+[start=6]
+. 按 F7 键三次。调试器将在调用函数 ``calculate_sum_of_factorials ()`` 的行上停止。"Local Variables"（局部变量）窗口会显示变量 ``$m`` 和 ``$n`` 以及它们的值：
+
image::images/degugger-stopped-at-function-call.png[]
-7. 要步入函数 ``calculate_sum_of_factorials ()`` ，请按 F7 键。调试器开始执行函数 ``calculate_sum_of_factorials ()`` 中的代码，然后在函数 ``calculate_factorial ()`` 的调用处停止。
+
+
+[start=7]
+. 要步入函数 ``calculate_sum_of_factorials ()`` ，请按 F7 键。调试器开始执行函数 ``calculate_sum_of_factorials ()`` 中的代码，然后在函数 ``calculate_factorial ()`` 的调用处停止。
+
image::images/call-of-embedded-function.png[]
+
现在，"Local Variables"（局部变量）窗口将显示函数 ``calculate_sum_of_factorials ()`` 中声明的局部变量 ``$argument1`` 和 ``$argument2`` 。
+
image::images/variables-inside-function-call-another-function.png[]
-8. 按 F7 键。调试器开始执行函数 ``calculate_factorial ()`` 中的代码。"Call Stack"（调用堆栈）窗口将按倒序显示函数的调用堆栈，最后调用的函数位于列表顶部：
+
+
+[start=8]
+. 按 F7 键。调试器开始执行函数 ``calculate_factorial ()`` 中的代码。"Call Stack"（调用堆栈）窗口将按倒序显示函数的调用堆栈，最后调用的函数位于列表顶部：
+
image::images/call-stack.png[]
-9. 按 F7 键步入循环。在 "Variables"（变量）窗口中查看变量值。
+
+[start=9]
+. 按 F7 键步入循环。在 "Variables"（变量）窗口中查看变量值。
+
image::images/local-variables-inside-loop.png[]
-10. 如果您确定代码运行正常，请按 Ctrl-F7/⌘-F7 组合键，以取消函数执行。程序将在调用函数 ``calculate_factorial ()`` 后返回至下一行。
-*注：*您也可以按 F7 键，直到程序执行完函数 ``calculate_factorial ()`` 为止。您也会在调用该函数后返回至下一行。
+
+
+[start=10]
+. 如果您确定代码运行正常，请按 Ctrl-F7/⌘-F7 组合键，以取消函数执行。程序将在调用函数 ``calculate_factorial ()`` 后返回至下一行。
+
+NOTE: 您也可以按 F7 键，直到程序执行完函数 ``calculate_factorial ()`` 为止。您也会在调用该函数后返回至下一行。
+
image::images/call-of-embedded-function-second-time.png[]
-11. 由于您刚检查了函数 ``calculate_factorial ()`` ，并且确定其运行正常，因此可以跳过对该函数的再次执行操作（“步过”）。要越过该函数，请按 F8 键。程序将在函数 ``calculate_sum ()`` 的调用处停止。
+
+
+[start=11]
+. 由于您刚检查了函数 ``calculate_factorial ()`` ，并且确定其运行正常，因此可以跳过对该函数的再次执行操作（“步过”）。要越过该函数，请按 F8 键。程序将在函数 ``calculate_sum ()`` 的调用处停止。
+
image::images/cal-of-embedded-function-calculate-sum.png[]
-12. 要步入函数 ``calculate_sum ()`` ，请按 F7 键。
-13. 要越过该函数，请按 F8 键。对于任何一种情况，调试器都会在函数 ``calculate_sum_of_factorials ()`` 的最后一行停止。
+
+
+[start=12]
+. 要步入函数 ``calculate_sum ()`` ，请按 F7 键。
+
+[start=13]
+. 要越过该函数，请按 F8 键。对于任何一种情况，调试器都会在函数 ``calculate_sum_of_factorials ()`` 的最后一行停止。
+
image::images/return-result.png[]
-14. 按 F7 键。调试器将移到 ``echo`` 语句所在的行上。
-15. 按 F7 键，直到调试器退出程序为止。将打开浏览器窗口并显示程序执行的结果：
+
+
+[start=14]
+. 按 F7 键。调试器将移到 ``echo`` 语句所在的行上。
+
+[start=15]
+. 按 F7 键，直到调试器退出程序为止。将打开浏览器窗口并显示程序执行的结果：
+
image::images/program-output.png[]
@@ -326,30 +387,38 @@ image::images/program-output.png[]
1. 按如下所示更新代码（将加号替换为减号）：
-[source,java]
+[source,php]
----
function calculate_sum ($argument1, $argument2) {return $argument1 - argument2;}
----
假定运算符的改变是由于拼写错误造成的，而实际上您需要计算和。
-2. 选择 "Debug"（调试）> "New Watch"（新建监视），或者按 Ctrl/⌘-shift-F7 组合键。"New Watch"（新建监视）窗口打开。
-3. 输入以下表达式，然后单击 "OK"（确定）。
-[source,java]
+[start=2]
+. 选择 "Debug"（调试）> "New Watch"（新建监视），或者按 Ctrl/⌘-shift-F7 组合键。"New Watch"（新建监视）窗口打开。
+
+[start=3]
+. 输入以下表达式，然后单击 "OK"（确定）。
+
+[source,php]
----
$factorial1+$factorial2
----
"Watches"（监视）窗口中将显示新表达式。
-4. 运行调试会话。当调试器在以下行停止时
-[source,java]
+[start=4]
+. 运行调试会话。当调试器在以下行停止时
+
+[source,php]
----
return $result;
----
将 "Watches"（监视）窗口中表达式的值与 "Local Variables"（局部变量）窗口中 $result 的值进行比较。它们应该相同，但在此示例中不同。
+
image::images/watches.png[]
+
此示例非常简单，它为您提供了使用监视的一些基本概念。
@@ -367,24 +436,34 @@ image::images/watches.png[]
有关详细信息，请参见 link:wish-list-lesson2.html#htmlForm[+HTML 输入窗体+]。
-2. 替换 <?php ?> 块下键入或粘贴以下代码：
-[source,java]
+[start=2]
+. 替换 <?php ?> 块下键入或粘贴以下代码：
+
+[source,php]
----
$m=5;$n=10;$sum_of_factorials = calculate_sum_of_factorials ($m, $n);echo "The sum of factorials of the entered integers is " . $sum_of_factorials;
----
替换为以下代码：
-[source,java]
+[source,php]
----
if (array_key_exists ("first_integer", $_POST) && array_key_exists ("second_integer", $_POST)) {$result = calculate_sum_of_factorials ($_POST["first_integer"], $_POST["second_integer"]);echo "Sum of factorials is " . $result;}
----
-3. 在 <?php ?> 块的开头设置断点，然后启动<<debuggingSession,调试会话>>。
-4. 按 F7 键。调试器将步入程序。同时，会打开浏览器窗口，但不显示输入窗体。这是调试器的正确行为，因为它必须首先通过 Web 页的整个源代码，然后才能显示该页面。实际上，这意味着调试器通过了两次代码。第一次是调试器处理代码以显示 HTML 输入窗体。第二次是调试器逐步执行 PHP 代码。
-5. 按 F7 键，直到调试器到达程序末尾并且打开输入窗体为止。
-6. 填写该窗体，然后单击 Enter 键。将继续调试会话（如<<sampleDebuggingSession,样例调试会话>>部分中所述）。
+
+[start=3]
+. 在 <?php ?> 块的开头设置断点，然后启动<<debuggingSession,调试会话>>。
+
+[start=4]
+. 按 F7 键。调试器将步入程序。同时，会打开浏览器窗口，但不显示输入窗体。这是调试器的正确行为，因为它必须首先通过 Web 页的整个源代码，然后才能显示该页面。实际上，这意味着调试器通过了两次代码。第一次是调试器处理代码以显示 HTML 输入窗体。第二次是调试器逐步执行 PHP 代码。
+
+[start=5]
+. 按 F7 键，直到调试器到达程序末尾并且打开输入窗体为止。
+
+[start=6]
+. 填写该窗体，然后单击 Enter 键。将继续调试会话（如<<sampleDebuggingSession,样例调试会话>>部分中所述）。
== [[路径映射、调试器代理以及在定制 URL 上启动调试会话]]
@@ -401,7 +480,9 @@ if (array_key_exists ("first_integer", $_POST) && array_key_exists ("sec
* "Ask Every Time"（每次都询问）：让 IDE 提示您在启动调试会话时输入 URL。
* "Do Not Open Web Browser"（不打开 Web 浏览器）：需要您手动打开浏览器并输入 URL（您需要 GET/POST XDEBUG_SESSION_START 变量）。
-6. 使用代理服务器进行调试时，请在 "Debugger Proxy"（调试器代理）类别中输入该服务器的主机名和端口。
+
+[start=6]
+. 使用代理服务器进行调试时，请在 "Debugger Proxy"（调试器代理）类别中输入该服务器的主机名和端口。
有关详细信息，请参见 "NetBeans for PHP"(NetBeans PHP) 博客中的 link:http://blogs.oracle.com/netbeansphp/entry/path_mapping_in_php_debugger[+Path Mapping in PHP Debugger+]（使用 PHP 调试器进行路径映射）的帖子。
diff --git a/netbeans.apache.org/src/content/kb/docs/php/phpunit.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/phpunit.asciidoc
index 8810b1c..d59a151 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/phpunit.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/phpunit.asciidoc
@@ -81,7 +81,9 @@ class Calculator
}
?>
----
-2. Add a comment block with the link:http://sebastian-bergmann.de/archives/628-Improved-Skeleton-Generator-in-PHPUnit-3.html[+@assert annotation+] and some sample input and output. Note that one incorrect assertion is included in this example.
+
+[start=2]
+. Add a comment block with the link:http://sebastian-bergmann.de/archives/628-Improved-Skeleton-Generator-in-PHPUnit-3.html[+@assert annotation+] and some sample input and output. Note that one incorrect assertion is included in this example.
[source,php]
----
@@ -104,24 +106,36 @@ class Calculator
?>
----
-*Note: *You can use annotation code completion to add `@assert` annotations. Navigate between parameters with the Tab key, or click Enter after filling in a parameter value.
+NOTE: You can use annotation code completion to add `@assert` annotations. Navigate between parameters with the Tab key, or click Enter after filling in a parameter value.
image::images/assert-cc.png[]image::images/assert-cc-complete.png[]
-3. In the Projects window, right-click the Calculator.php node and select Tools > Create PHPUnit Tests. Note that you can create tests for all files in a project in the context menu for the Source Files node.
+
+
+[start=3]
+. In the Projects window, right-click the Calculator.php node and select Tools > Create PHPUnit Tests. Note that you can create tests for all files in a project in the context menu for the Source Files node.
+
image::images/create-tests.png[]
-4. The first time you create tests, a dialog opens asking you for the directory in which you want to store test files. In this example, the Browse function was used to create a ``tests`` directory.
+
+
+[start=4]
+. The first time you create tests, a dialog opens asking you for the directory in which you want to store test files. In this example, the Browse function was used to create a ``tests`` directory.
+
image::images/test-directory.png[]
NOTE: You can manually write multiple tests for a project. If you write multiple tests, you can sort them into subfolders of the test file directory, such as "important" or "quick." You can then run tests in a subfolder by right-clicking that folder and selecting Run Tests.
image::images/test-in-folder.png[]
-5. The IDE generates a skeleton test class in a file called CalculatorTest.php, which appears in your Projects window and opens in the editor.
+
+
+[start=5]
+. The IDE generates a skeleton test class in a file called CalculatorTest.php, which appears in your Projects window and opens in the editor.
+
image::images/test-class-in-project.png[]
Note that a test is created for each ``@assert`` annotation.
-[source,java]
+[source,php]
----
/**
@@ -135,7 +149,10 @@ Note that a test is created for each ``@assert`` annotation.
);
}
----
-6. You can test either an individual file or the entire project. To test the project, right-click the project's parent node and select Test, or press Alt-F6. To test the Calculator.php file, right-clict the file's node and select Test, or press Ctrl-F6/⌘-F6. This example has only one class in one file, so the results are the same. The IDE runs the tests and displays the results in the Test Results window.
+
+[start=6]
+. You can test either an individual file or the entire project. To test the project, right-click the project's parent node and select Test, or press Alt-F6. To test the Calculator.php file, right-clict the file's node and select Test, or press Ctrl-F6/⌘-F6. This example has only one class in one file, so the results are the same. The IDE runs the tests and displays the results in the Test Results window.
+
image::images/test-results-narrow.png[]
A more verbose textual version of the results is displayed in the Output window.
@@ -155,12 +172,25 @@ To mark a test as part of a test group, annotate the test method with ``@group
1. In the Projects window, right-click the Calculator node and select Properties. The Project Properties open.
2. In the Project Properties, select the PhpUnit category. Select Ask for Test Groups Before Running Tests. Click OK.
+
image::images/test-group-properties.png[]
-3. Open ``CalculatorTest.php`` in the editor.
-4. For the methods ``testAdd`` , ``testAdd3`` and ``testAdd5`` , add the annotation ``@group production`` .
+
+
+[start=3]
+. Open ``CalculatorTest.php`` in the editor.
+
+[start=4]
+. For the methods ``testAdd`` , ``testAdd3`` and ``testAdd5`` , add the annotation ``@group production`` .
+
image::images/production-group-annotation.png[]
-5. For the methods ``testAdd2`` and ``testAdd4`` , add the annotations ``@group production`` and ``@group development`` . image::images/production-development-group-code.png[]
-6. Right-click the ``Calculator.php`` node and select Test. A dialog opens, asking you which test groups to run. Select "development" and click OK. The IDE only runs the tests that are annotated with ``@group development`` .
+
+
+[start=5]
+. For the methods ``testAdd2`` and ``testAdd4`` , add the annotations ``@group production`` and ``@group development`` . image::images/production-development-group-code.png[]
+
+[start=6]
+. Right-click the ``Calculator.php`` node and select Test. A dialog opens, asking you which test groups to run. Select "development" and click OK. The IDE only runs the tests that are annotated with ``@group development`` .
+
image::images/select-test-group.png[]
For more information about PhpUnit test groups in NetBeans IDE, see the NetBeans IDE for PHP blog post link:http://blogs.oracle.com/netbeansphp/entry/using_phpunit_test_groups[+Using PHP Unit Test Groups+].
@@ -181,13 +211,13 @@ image::images/test-results-tooltip.png[]
The Test Results window includes the following buttons on the left side:
-* Rerun the test image::images/rerun-button.png[]
-* Show failed tests image::images/show-failed.png[]
-* Show passed tests image::images/show-passed.png[]
-* Show tests that passed but with errors image::images/show-error.png[]
-* Navigate between showing the next test result image::images/next-test-button.png[] or the previous test result image::images/previous-test-button.png[]
+* Rerun the test image:images/rerun-button.png[]
+* Show failed tests image:images/show-failed.png[]
+* Show passed tests image:images/show-passed.png[]
+* Show tests that passed but with errors image:images/show-error.png[]
+* Navigate between showing the next test result image:images/next-test-button.png[] or the previous test result image:images/previous-test-button.png[]
-The Output window shows the full output of the PHPUnit script. It can be useful when you cannot identify the cause of an error with the information in the Test Results window. Like Test Results, the Output window includes links to the test class line that failed. It also includes buttons on the left side for rerunning the test and for opening the PHP Options window. image::images/options-link-button.png[]
+The Output window shows the full output of the PHPUnit script. It can be useful when you cannot identify the cause of an error with the information in the Test Results window. Like Test Results, the Output window includes links to the test class line that failed. It also includes buttons on the left side for rerunning the test and for opening the PHP Options window. image:images/options-link-button.png[]
image::images/test-result-output.png[]
@@ -225,21 +255,38 @@ class Calculator {
?>
----
-2. Right-click the project node. From the context menu, select Code Coverage > Collect and Display Code Coverage. By default, Show Editor Bar is also selected.
+
+[start=2]
+. Right-click the project node. From the context menu, select Code Coverage > Collect and Display Code Coverage. By default, Show Editor Bar is also selected.
+
image::images/turn-on-code-coverage.png[]
-3. The editor now has a code coverage editor bar across the bottom. Because code coverage has not been tested, the editor bar reports 0% coverage. (It also displays this after you click Clear to clear test results.)
+
+
+[start=3]
+. The editor now has a code coverage editor bar across the bottom. Because code coverage has not been tested, the editor bar reports 0% coverage. (It also displays this after you click Clear to clear test results.)
+
image::images/editor-bar-before.png[]
-4. Click Test to test the open file or All Tests to run all tests for the project. The Test Results display. In addition, the Code Coverage bar tells you what percentage of your executable code statements is covered by tests. In the editor window, covered code is highlighted in green and uncovered code is highlighted in red.
-*Warning: *If you re-generate the test files AFTER adding the add2 function, the PHPUnit tests will not run. This is because PHPUnit creates two conflicting testAdd2 functions. Do not differentiate functions by appending numbers at the end if you plan to use PHPUnit on more than one such function. See the link:http://www.phpunit.de/ticket/701[+the PHPUnit documentation+].
+
+[start=4]
+. Click Test to test the open file or All Tests to run all tests for the project. The Test Results display. In addition, the Code Coverage bar tells you what percentage of your executable code statements is covered by tests. In the editor window, covered code is highlighted in green and uncovered code is highlighted in red.
+
+WARNING: If you re-generate the test files AFTER adding the add2 function, the PHPUnit tests will not run. This is because PHPUnit creates two conflicting testAdd2 functions. Do not differentiate functions by appending numbers at the end if you plan to use PHPUnit on more than one such function. See the link:http://www.phpunit.de/ticket/701[+the PHPUnit documentation+].
image::images/editor-bar-after.png[]
-5. In the Editor Bar, click on Report... The Code Coverage report opens, showing the results of all tests run on your project. Buttons in the report let you clear the results, run all the tests again, or deactivate code coverage (click Done).
+
+
+[start=5]
+. In the Editor Bar, click on Report... The Code Coverage report opens, showing the results of all tests run on your project. Buttons in the report let you clear the results, run all the tests again, or deactivate code coverage (click Done).
+
image::images/code-coverage-report.png[]
-6. You can add another class to your project, delete and recreate the test files and look at the code coverage report again. Your new class is listed. In the following report, the ``Calculator`` class again has a function that is not included in the tests.
-image::images/code-coverage-report2.png[]
+[start=6]
+. You can add another class to your project, delete and recreate the test files and look at the code coverage report again. Your new class is listed. In the following report, the ``Calculator`` class again has a function that is not included in the tests.
+
+image::images/code-coverage-report2.png[]
+
[[project-specific-configurations]]
== Using Project-Specific Configurations
@@ -253,10 +300,17 @@ In the IDE, you can select the following custom configurations for your project:
*To set a project-specific configuration:*
1. Right-click the project's node or the project's Test Files node and select Properties. This opens the Properties dialog.
+
image::images/project-ctxmenu.png[]
-2. Select the PHPUnit category. A dialog opens in which you can select a custom bootstrap, XML configuration, PHPUnit script, or test suite file.
+
+[start=2]
+. Select the PHPUnit category. A dialog opens in which you can select a custom bootstrap, XML configuration, PHPUnit script, or test suite file.
+
image::images/proj-properties.png[]
-3. If you are not familiar with the structure of bootstrap or XML configuration files, you can use NetBeans IDE to generate a skeleton for you. You can also find instructions about using the dialog by clicking Help.
+
+[start=3]
+. If you are not familiar with the structure of bootstrap or XML configuration files, you can use NetBeans IDE to generate a skeleton for you. You can also find instructions about using the dialog by clicking Help.
+
image::images/proj-properties-selected.png[]
The _bootstrap option_ is required for projects that use a custom class loader, for example by implementing the ``__autoload()`` magic function. You also use the bootstrap option if you need to include a file in advance, such as a file that defines global constants used by multiple classes in your project.
@@ -282,11 +336,19 @@ NetBeans IDE has a plugin that includes a Selenium server. With this plugin, you
1. Open a command prompt and run the command ``pear install Testing_Selenium-beta`` . You need `` PHP_HOME/php/PEAR`` on your Path. If the command is successful, the prompt will display ``install ok: channel://pear.php.net/Testing_Selenium-0.4.3`` .
2. In the IDE, open Tools > Plugins and install the Selenium Module for PHP.
3. In the Projects window, right-click the project node for your Calculator project. Select New > Other. The New File wizard opens. Select Selenium and click Next.
+
image::images/new-selenium.png[]
-4. The first time you create a Selenium test, a dialog opens asking you to set a directory for Selenium test files. This should be a separate directory from PHPUnit test files. Otherwise, the Selenium tests run every time you run unit tests. Running functional tests like Selenium usually takes more time than running unit tests, therefore you will probably not want to run these tests every time you run unit tests.
-5. Accept the defaults in the Name and Location page and click Finish. The new Selenium test file opens in the editor and appears in the Projects window.
+
+[start=4]
+. The first time you create a Selenium test, a dialog opens asking you to set a directory for Selenium test files. This should be a separate directory from PHPUnit test files. Otherwise, the Selenium tests run every time you run unit tests. Running functional tests like Selenium usually takes more time than running unit tests, therefore you will probably not want to run these tests every time you run unit tests.
+
+[start=5]
+. Accept the defaults in the Name and Location page and click Finish. The new Selenium test file opens in the editor and appears in the Projects window.
+
image::images/selenium-test-in-project.png[]
-6. The Run Selenium Tests item is now added to the project's context menu. Click this item, and the Selenium test results display in the Test Results window, the same as PHPUnit tests.
+
+[start=6]
+. The Run Selenium Tests item is now added to the project's context menu. Click this item, and the Selenium test results display in the Test Results window, the same as PHPUnit tests.
[[more-exercises]]
diff --git a/netbeans.apache.org/src/content/kb/docs/php/phpunit_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/phpunit_ja.asciidoc
index 65ed107..affc219 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/phpunit_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/phpunit_ja.asciidoc
@@ -34,9 +34,6 @@ PHP向けのNetBeans IDEは、link:http://www.phpunit.de[+PHPUnit+]自動化テ
NetBeans IDEでは、PHPUnitに加えて、Seleniumの移植可能なテスト・フレームワークもサポートされています。Seleniumプラグインは、更新センターから入手できます。このプラグインをインストールすると、SeleniumサーバーがIDEの登録済サーバーに追加され、Seleniumのテスト・オプションがPHPのメニューに追加されます。
-image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、NetBeans IDE 7.2、7.3、7.4および8.0に適用されます"]
-
-
*このチュートリアルに従うには、次のソフトウェアとリソースが必要です。*
|===
@@ -87,7 +84,9 @@ class Calculator
}
?>
----
-2. link:http://sebastian-bergmann.de/archives/628-Improved-Skeleton-Generator-in-PHPUnit-3.html[+@assert注釈+]と、入力と出力の例を使用したコメント・ブロックを追加します。この例には間違った表明が1つ含まれています。
+
+[start=2]
+. link:http://sebastian-bergmann.de/archives/628-Improved-Skeleton-Generator-in-PHPUnit-3.html[+@assert注釈+]と、入力と出力の例を使用したコメント・ブロックを追加します。この例には間違った表明が1つ含まれています。
[source,php]
----
@@ -110,24 +109,38 @@ class Calculator
?>
----
-*注意: *注釈のコード補完を使用して、`@assert`注釈を追加できます。[Tab]キーを使用してパラメータ間を移動するか、またはパラメータ値を入力して[Enter]を押します。
+NOTE: 注釈のコード補完を使用して、`@assert`注釈を追加できます。[Tab]キーを使用してパラメータ間を移動するか、またはパラメータ値を入力して[Enter]を押します。
+
+image::images/assert-cc.png[]
+
+image::images/assert-cc-complete.png[]
+
+
+[start=3]
+. 「プロジェクト」ウィンドウで「Calculator.php」ノードを右クリックし、「ツール」>「PHPUnitテストを作成」を選択します。「ソース・ファイル」ノードのコンテキスト・メニューで、プロジェクト内のすべてのファイルのテストを作成できます。
-image::images/assert-cc.png[]image::images/assert-cc-complete.png[]
-3. 「プロジェクト」ウィンドウで「Calculator.php」ノードを右クリックし、「ツール」>「PHPUnitテストを作成」を選択します。「ソース・ファイル」ノードのコンテキスト・メニューで、プロジェクト内のすべてのファイルのテストを作成できます。
image::images/create-tests.png[]
-4. テストを初めて作成するときは、テスト・ファイルを保存するディレクトリを指定するダイアログが開きます。この例では、参照機能を使用して ``tests`` ディレクトリを作成しています。
+
+
+[start=4]
+. テストを初めて作成するときは、テスト・ファイルを保存するディレクトリを指定するダイアログが開きます。この例では、参照機能を使用して ``tests`` ディレクトリを作成しています。
+
image::images/test-directory.png[]
-*注意:* 1つのプロジェクトに複数のテストを手動で記述できます。複数のテストを記述する場合は、テスト・ファイルのディレクトリのサブディレクトリ(たとえば、"important"、"quick")に、それらのテストをソートできます。次に、サブフォルダを右クリックし、「テストの実行」を選択して、サブフォルダ内のテストを実行できます。
+NOTE: 1つのプロジェクトに複数のテストを手動で記述できます。複数のテストを記述する場合は、テスト・ファイルのディレクトリのサブディレクトリ(たとえば、"important"、"quick")に、それらのテストをソートできます。次に、サブフォルダを右クリックし、「テストの実行」を選択して、サブフォルダ内のテストを実行できます。
image::images/test-in-folder.png[]
-5. IDEによって、CalculatorTest.phpというファイルに、スケルトン・テスト・クラスが生成されます(このファイルは、「プロジェクト」ウィンドウに表示され、エディタで開きます)。
+
+
+[start=5]
+. IDEによって、CalculatorTest.phpというファイルに、スケルトン・テスト・クラスが生成されます(このファイルは、「プロジェクト」ウィンドウに表示され、エディタで開きます)。
+
image::images/test-class-in-project.png[]
``@assert`` 注釈ごとにテストが作成されます。
-[source,java]
+[source,php]
----
/**
@@ -141,7 +154,10 @@ image::images/test-class-in-project.png[]
);
}
----
-6. 1つのファイルまたはプロジェクト全体をテストできます。プロジェクトをテストするには、プロジェクトの親ノードを右クリックして「テスト」を選択するか、または[Alt]-[F6]を押します。Calculator.phpファイルをテストするには、ファイルのノードを右クリックして「テスト」を選択するか、または[Ctrl]-[F6]/[⌘]-[F6]を押します。この例では、1つのファイルに1つのクラスのみがあるため、結果は同じです。IDEによってテストが実行され、「テスト結果」ウィンドウに結果が表示されます。
+
+[start=6]
+. 1つのファイルまたはプロジェクト全体をテストできます。プロジェクトをテストするには、プロジェクトの親ノードを右クリックして「テスト」を選択するか、または[Alt]-[F6]を押します。Calculator.phpファイルをテストするには、ファイルのノードを右クリックして「テスト」を選択するか、または[Ctrl]-[F6]/[⌘]-[F6]を押します。この例では、1つのファイルに1つのクラスのみがあるため、結果は同じです。IDEによってテストが実行され、「テスト結果」ウィンドウに結果が表示されます。
+
image::images/test-results-narrow.png[]
より詳細なテキスト・バージョンの結果が「出力」ウィンドウに表示されます。
@@ -161,12 +177,25 @@ PHPプロジェクト内の任意のファイルについてテスト・グル
1. 「プロジェクト」ウィンドウで「Calculator」ノードを右クリックし、「プロパティ」を選択します。「プロジェクト・プロパティ」が開きます。
2. 「プロジェクト・プロパティ」で「PHPUnit」カテゴリを選択します。「テストの実行前にテスト・グループの入力を求める」を選択します。「OK」をクリックします。
+
image::images/test-group-properties.png[]
-3. エディタで ``CalculatorTest.php`` を開きます。
-4. メソッド ``testAdd`` 、 ``testAdd3`` 、および ``testAdd5`` について、注釈 ``@group production`` を追加します。
+
+
+[start=3]
+. エディタで ``CalculatorTest.php`` を開きます。
+
+[start=4]
+. メソッド ``testAdd`` 、 ``testAdd3`` 、および ``testAdd5`` について、注釈 ``@group production`` を追加します。
+
image::images/production-group-annotation.png[]
-5. メソッド ``testAdd2`` および ``testAdd4`` について、注釈 ``@group production`` および ``@group development`` を追加します。image::images/production-development-group-code.png[]
-6. ``Calculator.php`` ノードを右クリックし、「テスト」を選択します。ダイアログが開き、実行するテスト・グループを指定するように求められます。「development」を選択して「OK」をクリックします。IDEは、 ``@group development`` という注釈が付いたテストのみを実行します。
+
+
+[start=5]
+. メソッド ``testAdd2`` および ``testAdd4`` について、注釈 ``@group production`` および ``@group development`` を追加します。image:images/production-development-group-code.png[]
+
+[start=6]
+. ``Calculator.php`` ノードを右クリックし、「テスト」を選択します。ダイアログが開き、実行するテスト・グループを指定するように求められます。「development」を選択して「OK」をクリックします。IDEは、 ``@group development`` という注釈が付いたテストのみを実行します。
+
image::images/select-test-group.png[]
NetBeans IDEのPHPUnitテスト・グループの詳細は、PHP向けのNetBeans IDEブログ投稿のlink:http://blogs.oracle.com/netbeansphp/entry/using_phpunit_test_groups[+PHPUnitテスト・グループの使用+]を参照してください。
@@ -187,13 +216,13 @@ image::images/test-results-tooltip.png[]
「テスト結果」ウィンドウの左側には次のボタンがあります。
-* テストを再実行image::images/rerun-button.png[]
-* 失敗したテストの表示image::images/show-failed.png[]
-* 成功したテストの表示image::images/show-passed.png[]
-* 成功したがエラーがあるテストの表示image::images/show-error.png[]
-* 次のテスト結果image::images/next-test-button.png[]または前のテスト結果image::images/previous-test-button.png[]への移動
+* テストを再実行image:images/rerun-button.png[]
+* 失敗したテストの表示image:images/show-failed.png[]
+* 成功したテストの表示image:images/show-passed.png[]
+* 成功したがエラーがあるテストの表示image:images/show-error.png[]
+* 次のテスト結果image:images/next-test-button.png[]または前のテスト結果image:images/previous-test-button.png[]への移動
-「出力」ウィンドウには、PHPUnitスクリプトの完全な出力が表示されます。「テスト結果」ウィンドウ内の情報ではエラーの原因を特定できない場合に便利です。「テスト結果」ウィンドウと同様に、「出力」ウィンドウには、失敗したテスト・クラス行へのリンクが含まれます。また、テストを再実行したり、PHPの「オプション」ウィンドウを開いたりするためのボタンが左側にあります。image::images/options-link-button.png[]
+「出力」ウィンドウには、PHPUnitスクリプトの完全な出力が表示されます。「テスト結果」ウィンドウ内の情報ではエラーの原因を特定できない場合に便利です。「テスト結果」ウィンドウと同様に、「出力」ウィンドウには、失敗したテスト・クラス行へのリンクが含まれます。また、テストを再実行したり、PHPの「オプション」ウィンドウを開いたりするためのボタンが左側にあります。image:images/options-link-button.png[]
image::images/test-result-output.png[]
@@ -231,18 +260,36 @@ class Calculator {
?>
----
-2. プロジェクト・ノードを右クリックします。コンテキスト・メニューから、「コード・カバレージ」>「コード・カバレージを収集し表示」を選択します。デフォルトでは、「エディタ・バーを表示」も選択されています。
+
+[start=2]
+. プロジェクト・ノードを右クリックします。コンテキスト・メニューから、「コード・カバレージ」>「コード・カバレージを収集し表示」を選択します。デフォルトでは、「エディタ・バーを表示」も選択されています。
+
image::images/turn-on-code-coverage.png[]
-3. エディタの最下部に、コード・カバレージのエディタ・バーが表示されます。コード・カバレージはテストされていないので、エディタ・バーには0%のカバレージが表示されます。(「クリア」をクリックしてテスト結果をクリアした後もこのように表示されます。)
+
+
+[start=3]
+. エディタの最下部に、コード・カバレージのエディタ・バーが表示されます。コード・カバレージはテストされていないので、エディタ・バーには0%のカバレージが表示されます。(「クリア」をクリックしてテスト結果をクリアした後もこのように表示されます。)
+
image::images/editor-bar-before.png[]
-4. 「テスト」をクリックして開いているファイルをテストするか、または「すべてのテスト」をクリックしてプロジェクトのすべてのテストを実行します。テスト結果が表示されます。また、コード・カバレージのバーに、テストでカバーされている実行可能コード文の割合(パーセント)が示されます。エディタ・ウィンドウで、カバーされているコードは緑色で強調表示され、カバーされていないコードは赤で強調表示されます。
+
+
+[start=4]
+. 「テスト」をクリックして開いているファイルをテストするか、または「すべてのテスト」をクリックしてプロジェクトのすべてのテストを実行します。テスト結果が表示されます。また、コード・カバレージのバーに、テストでカバーされている実行可能コード文の割合(パーセント)が示されます。エディタ・ウィンドウで、カバーされているコードは緑色で強調表示され、カバーされていないコードは赤で強調表示されます。
*警告: *add2関数を追加した後でテスト・ファイルを再生成した場合、PHPUnitテストは実行されません。これは、PHPUnitが2つの競合するtestAdd2関数を作成するためです。このような複数の関数についてPHPUnitを使用する場合、末尾に数字を付加することによって関数を区別しないでください。link:http://www.phpunit.de/ticket/701[+PHPUnitのドキュメント+]を参照してください。
image::images/editor-bar-after.png[]
-5. エディタ・バーで、「レポート」をクリックします。コード・カバレージのレポートが開き、プロジェクトに対して実行されたすべてのテストの結果が表示されます。レポート内のボタンを使用して、結果をクリアしたり、すべてのテストを再実行したり、コード・カバレージを非アクティブ化(「完了」をクリック)できます。
+
+
+[start=5]
+. エディタ・バーで、「レポート」をクリックします。コード・カバレージのレポートが開き、プロジェクトに対して実行されたすべてのテストの結果が表示されます。レポート内のボタンを使用して、結果をクリアしたり、すべてのテストを再実行したり、コード・カバレージを非アクティブ化(「完了」をクリック)できます。
+
image::images/code-coverage-report.png[]
-6. プロジェクトに別のクラスを追加し、テスト・ファイルを削除して再作成して、コード・カバレージのレポートをもう一度確認できます。新しいクラスが表示されます。次のレポートでは、 ``Calculator`` クラスに、テストに含まれない関数が再度含まれています。
+
+
+[start=6]
+. プロジェクトに別のクラスを追加し、テスト・ファイルを削除して再作成して、コード・カバレージのレポートをもう一度確認できます。新しいクラスが表示されます。次のレポートでは、 ``Calculator`` クラスに、テストに含まれない関数が再度含まれています。
+
image::images/code-coverage-report2.png[]
@@ -258,11 +305,22 @@ IDEでは、プロジェクトに次のカスタム構成を選択できます
*プロジェクト固有の構成を設定するには:*
-1. プロジェクトのノードまたはプロジェクトの「テスト・ファイル」ノードを右クリックし、「プロパティ」を選択します。「プロパティ」ダイアログが開きます。
+
+[start=1]
+. プロジェクトのノードまたはプロジェクトの「テスト・ファイル」ノードを右クリックし、「プロパティ」を選択します。「プロパティ」ダイアログが開きます。
+
image::images/project-ctxmenu.png[]
-2. 「PHPUnit」カテゴリを選択します。カスタムのブートストラップ、XML構成、PHPUnitスクリプト、またはテスト・スイート・ファイルを選択できるダイアログが開きます。
+
+
+[start=2]
+. 「PHPUnit」カテゴリを選択します。カスタムのブートストラップ、XML構成、PHPUnitスクリプト、またはテスト・スイート・ファイルを選択できるダイアログが開きます。
+
image::images/proj-properties.png[]
-3. ブートストラップの構造やXML構成ファイルに精通していない場合は、NetBeans IDEを使用してスケルトンを生成できます。また、「ヘルプ」をクリックして、ダイアログを使用する手順を調べることができます。
+
+
+[start=3]
+. ブートストラップの構造やXML構成ファイルに精通していない場合は、NetBeans IDEを使用してスケルトンを生成できます。また、「ヘルプ」をクリックして、ダイアログを使用する手順を調べることができます。
+
image::images/proj-properties-selected.png[]
カスタム・クラス・ローダーを使用するプロジェクトの場合、 ``__autoload()`` 特殊関数の実装などによる、_ブートストラップ・オプション_が必要です。プロジェクトの複数のクラスで使用するグローバル定数を定義するファイルなど、事前にファイルを含める必要がある場合も、ブートストラップ・オプションを使用します。
@@ -288,11 +346,21 @@ NetBeans IDEには、Seleniumサーバーを含むプラグインがあります
1. コマンド・プロンプトを開き、コマンド ``pear install Testing_Selenium-beta`` を実行します。パスに ``PHP_HOME/php/PEAR`` が含まれている必要があります。コマンドが正常に完了したら、プロンプトに ``install ok: channel://pear.php.net/Testing_Selenium-0.4.3`` と表示されます。
2. IDEで、「ツール」>「プラグイン」を開き、PHP向けのSeleniumモジュールをインストールします。
3. 「プロジェクト」ウィンドウで、Calculatorプロジェクトのプロジェクト・ノードを右クリックします。「新規」>「その他」を選択します。新規ファイル・ウィザードが開きます。「Selenium」を選択し、「次」をクリックします。
+
image::images/new-selenium.png[]
-4. Seleniumのテストを初めて作成するときは、Seleniumのテスト・ファイル用のディレクトリを設定するダイアログが開きます。これは、PHPUnitのテスト・ファイルとは別のディレクトリにします。そうしないと、単体テストを実行するたびにSeleniumのテストが実行されます。Seleniumのような機能的なテストの実行は、単体テストの実行よりも時間がかかるため、単体テストを実行するたびにこれらのテストが実行されることは避けたい場合があります。
-5. 名前と場所ページの設定はデフォルトのままにし、「終了」をクリックします。Seleniumの新しいテスト・ファイルがエディタで開き、「プロジェクト」ウィンドウに表示されます。
+
+
+[start=4]
+. Seleniumのテストを初めて作成するときは、Seleniumのテスト・ファイル用のディレクトリを設定するダイアログが開きます。これは、PHPUnitのテスト・ファイルとは別のディレクトリにします。そうしないと、単体テストを実行するたびにSeleniumのテストが実行されます。Seleniumのような機能的なテストの実行は、単体テストの実行よりも時間がかかるため、単体テストを実行するたびにこれらのテストが実行されることは避けたい場合があります。
+
+[start=5]
+. 名前と場所ページの設定はデフォルトのままにし、「終了」をクリックします。Seleniumの新しいテスト・ファイルがエディタで開き、「プロジェクト」ウィンドウに表示されます。
+
image::images/selenium-test-in-project.png[]
-6. プロジェクトのコンテキスト・メニューに「Run Selenium Tests」という項目が追加されます。この項目をクリックすると、PHPUnitテストと同様に、Seleniumのテスト結果が「テスト結果」ウィンドウに表示されます。
+
+
+[start=6]
+. プロジェクトのコンテキスト・メニューに「Run Selenium Tests」という項目が追加されます。この項目をクリックすると、PHPUnitテストと同様に、Seleniumのテスト結果が「テスト結果」ウィンドウに表示されます。
[[more-exercises]]
diff --git a/netbeans.apache.org/src/content/kb/docs/php/phpunit_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/phpunit_pt_BR.asciidoc
index e3c4290..baea026 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/phpunit_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/phpunit_pt_BR.asciidoc
@@ -87,7 +87,9 @@ class Calculator
}
?>
----
-2. Adicione um bloco de comentário com a link:http://sebastian-bergmann.de/archives/628-Improved-Skeleton-Generator-in-PHPUnit-3.html[+anotação @assert+] e alguma amostra de entrada e saída. Observe que uma afirmação incorreta está incluída neste exemplo.
+
+[start=2]
+. Adicione um bloco de comentário com a link:http://sebastian-bergmann.de/archives/628-Improved-Skeleton-Generator-in-PHPUnit-3.html[+anotação @assert+] e alguma amostra de entrada e saída. Observe que uma afirmação incorreta está incluída neste exemplo.
[source,php]
----
@@ -110,24 +112,36 @@ class Calculator
?>
----
-*Observação: *Você pode usar autocompletar código da anotação para adicionar aotações `@assert`. Navegue entre os parâmetros com a tecla Tab ou clique em Enter depois de preencher um valor de parâmetro.
+NOTE: Você pode usar autocompletar código da anotação para adicionar aotações `@assert`. Navegue entre os parâmetros com a tecla Tab ou clique em Enter depois de preencher um valor de parâmetro.
image::images/assert-cc.png[]image::images/assert-cc-complete.png[]
-3. Na janela Projetos, clique com o botão direito do mouse no nó Calulator.php e selecione Ferramentas > Criar Testes PHPUnit. Observe que você pode criar testes para todos os arquivos em um projeto a partir do menu de contexto para o nó Arquivos de Código-Fonte.
+
+
+[start=3]
+. Na janela Projetos, clique com o botão direito do mouse no nó Calulator.php e selecione Ferramentas > Criar Testes PHPUnit. Observe que você pode criar testes para todos os arquivos em um projeto a partir do menu de contexto para o nó Arquivos de Código-Fonte.
+
image::images/create-tests.png[]
-4. Na primeira vez que você cria testes, uma caixa de diálogo é aberta perguntando pelo diretório onde deseja armazenar os arquivos de teste. Nesse exemplo, a função Procurar foi utilizada para criar um diretório ``testes`` .
+
+
+[start=4]
+. Na primeira vez que você cria testes, uma caixa de diálogo é aberta perguntando pelo diretório onde deseja armazenar os arquivos de teste. Nesse exemplo, a função Procurar foi utilizada para criar um diretório ``testes`` .
+
image::images/test-directory.png[]
-*Observação:* você pode escrever, manualmente, vários testes para um projeto. Se escrever vários testes, você poderá organizá-los em subpastas do diretório de arquivos de teste, como "importante" ou "rápido". Em seguida, você poderá executar testes em uma subpasta clicando com o botão direito do mouse nessa pasta e selecionando Executar Testes.
+NOTE: você pode escrever, manualmente, vários testes para um projeto. Se escrever vários testes, você poderá organizá-los em subpastas do diretório de arquivos de teste, como "importante" ou "rápido". Em seguida, você poderá executar testes em uma subpasta clicando com o botão direito do mouse nessa pasta e selecionando Executar Testes.
image::images/test-in-folder.png[]
-5. O IDE gera uma classe de teste de esqueleto em um arquivo denominado CalculatorTest.php, que aparece em sua janela Projetos e é aberta no editor.
+
+
+[start=5]
+. O IDE gera uma classe de teste de esqueleto em um arquivo denominado CalculatorTest.php, que aparece em sua janela Projetos e é aberta no editor.
+
image::images/test-class-in-project.png[]
Observe que um teste é criado para cada anotação ``@assert`` .
-[source,java]
+[source,php]
----
/**
@@ -141,7 +155,10 @@ Observe que um teste é criado para cada anotação ``@assert`` .
);
}
----
-6. É possível testar um arquivo individual ou todo o projeto. Para testar o projeto, clique com o botão direito do mouse no nó pai do projeto e selecione Testar ou pressione Alt-F6. Para testar o arquivo Calculator.php, clique com o botão direito do mouse no nó do arquivo e selecione Testar ou pressione Ctrl-F6/⌘-F6. Esse exemplo tem somente uma classe em um arquivo, portanto, os resultados são os mesmos. O IDE executa os testes e exibe os resultados na janela Resultados do Teste.
+
+[start=6]
+. É possível testar um arquivo individual ou todo o projeto. Para testar o projeto, clique com o botão direito do mouse no nó pai do projeto e selecione Testar ou pressione Alt-F6. Para testar o arquivo Calculator.php, clique com o botão direito do mouse no nó do arquivo e selecione Testar ou pressione Ctrl-F6/⌘-F6. Esse exemplo tem somente uma classe em um arquivo, portanto, os resultados são os mesmos. O IDE executa os testes e exibe os resultados na janela Resultados do Teste.
+
image::images/test-results-narrow.png[]
Uma versão textual mais detalhada dos resultados é exibida na janela de Saída.
@@ -161,12 +178,25 @@ Para marcar um teste como parte de um grupo de teste, anote o método de teste c
1. Na janela Projetos, clique com o botão direito do mouse no nó Calculadora e selecione Propriedades. Serão Exibidas as Propriedades do Projeto.
2. Nas Propriedades do Projeto, selecione a categoria PhpUnit. Selecione Solicitar Grupos de Teste, Antes de Executar os Testes. Clique em OK.
+
image::images/test-group-properties.png[]
-3. Abra ``CalculatorTest.php`` no editor.
-4. Para os métodos ``testAdd`` , ``testAdd3`` e ``testAdd5`` , acrescente a anotação ``@group production`` .
+
+
+[start=3]
+. Abra ``CalculatorTest.php`` no editor.
+
+[start=4]
+. Para os métodos ``testAdd`` , ``testAdd3`` e ``testAdd5`` , acrescente a anotação ``@group production`` .
+
image::images/production-group-annotation.png[]
-5. para os métodos ``testAdd2`` e ``testAdd4`` , adicione as anotações ``@group production`` e ``desenvolvimento @group`` . image::images/production-development-group-code.png[]
-6. Clique com o botão direito do mouse no nó ``Calculator.php`` e selecione Teste. Uma caixa de diálogo será aberta, perguntando quais grupos de teste serão executados. Selecione “development” e clique em OK. O IDE só executa os testes anotados com ``@group development`` .
+
+
+[start=5]
+. para os métodos ``testAdd2`` e ``testAdd4`` , adicione as anotações ``@group production`` e ``desenvolvimento @group`` . image:images/production-development-group-code.png[]
+
+[start=6]
+. Clique com o botão direito do mouse no nó ``Calculator.php`` e selecione Teste. Uma caixa de diálogo será aberta, perguntando quais grupos de teste serão executados. Selecione “development” e clique em OK. O IDE só executa os testes anotados com ``@group development`` .
+
image::images/select-test-group.png[]
Para obter mais informações sobre os grupos de teste PhpUnit no NetBeans IDE, consulte o post do blog do NetBeans IDE para PHPlink:http://blogs.oracle.com/netbeansphp/entry/using_phpunit_test_groups[+Usando Grupos de Teste da Unidade PHP+].
@@ -187,13 +217,13 @@ image::images/test-results-tooltip.png[]
A janela Resultados do teste inclui os seguintes botões no lado esquerdo:
-* Reexecutar o teste image::images/rerun-button.png[]
-* Mostrar testes com falha image::images/show-failed.png[]
-* Mostrar testes que passaram image::images/show-passed.png[]
-* Mostrar testes que passaram, mas com erros image::images/show-error.png[]
-* Navegue entre mostrar o próximo resultado do teste image::images/next-test-button.png[] ou o resultado do teste anterior image::images/previous-test-button.png[]
+* Reexecutar o teste image:images/rerun-button.png[]
+* Mostrar testes com falha image:images/show-failed.png[]
+* Mostrar testes que passaram image:images/show-passed.png[]
+* Mostrar testes que passaram, mas com erros image:images/show-error.png[]
+* Navegue entre mostrar o próximo resultado do teste image:images/next-test-button.png[] ou o resultado do teste anterior image:images/previous-test-button.png[]
-A janela de Saída mostra a saída completa do script PHPUnit. Ela pode ser útil quando você não pode identificar a causa de um erro com as informações na janela Resultados do Teste. Como na janela Resultados do Teste, a janela de Saída inclui links para a linha da classe de teste que falhou. Também inclui botões no lado esquerdo para reexecutar o teste e para abrir a janela Opções do PHP. image::images/options-link-button.png[]
+A janela de Saída mostra a saída completa do script PHPUnit. Ela pode ser útil quando você não pode identificar a causa de um erro com as informações na janela Resultados do Teste. Como na janela Resultados do Teste, a janela de Saída inclui links para a linha da classe de teste que falhou. Também inclui botões no lado esquerdo para reexecutar o teste e para abrir a janela Opções do PHP. image:images/options-link-button.png[]
image::images/test-result-output.png[]
@@ -231,18 +261,35 @@ class Calculator {
?>
----
-2. Clique com o botão direito do mouse no nó do projeto. No menu de contexto, selecione Cobertura de Código > Coletar e Exibir a Cobertura de Código. Por default, Mostrar Barra do Editor também é selecionado.
+
+[start=2]
+. Clique com o botão direito do mouse no nó do projeto. No menu de contexto, selecione Cobertura de Código > Coletar e Exibir a Cobertura de Código. Por default, Mostrar Barra do Editor também é selecionado.
+
image::images/turn-on-code-coverage.png[]
-3. O editor agora tem uma barra do editor de cobertura de código na parte inferior. Como a cobertura do código ainda não foi testada, a barra do editor informa 0% de cobertura. (Ela também exibe isso após você clicar em Limpar para limpar os resultados do teste).
-image::images/editor-bar-before.png[]
-4. Clique em Testar para testar o arquivo aberto ou em Todos os Testes para executar todos os testes do projeto. Os Resultados do Teste serão Exibidos. Além disso, a barra Cobertura de Código lhe informa qual a porcentagem das instruções de código executáveis é coberta pelos testes. Na janela editor, o código coberto é realçado em verde e o código não coberto é realçado em vermelho.
-*Advertência: *se os arquivos de testes forem gerados novamente DEPOIS da adição da função add2, os testes PHPUnit não serão executados. Isso ocorre porque o PHPUnit cria duas funções testAdd2 conflitantes. Não diferencie funções acrescentando números no final, caso pretenda usar o PHPUnit em mais de uma função como essa. Consulte a link:http://www.phpunit.de/ticket/701[+documentação do PHPUnit+].
+
+[start=3]
+. O editor agora tem uma barra do editor de cobertura de código na parte inferior. Como a cobertura do código ainda não foi testada, a barra do editor informa 0% de cobertura. (Ela também exibe isso após você clicar em Limpar para limpar os resultados do teste).
+ image::images/editor-bar-before.png[]
+
+
+[start=4]
+. Clique em Testar para testar o arquivo aberto ou em Todos os Testes para executar todos os testes do projeto. Os Resultados do Teste serão Exibidos. Além disso, a barra Cobertura de Código lhe informa qual a porcentagem das instruções de código executáveis é coberta pelos testes. Na janela editor, o código coberto é realçado em verde e o código não coberto é realçado em vermelho.
+
+WARNING: se os arquivos de testes forem gerados novamente DEPOIS da adição da função add2, os testes PHPUnit não serão executados. Isso ocorre porque o PHPUnit cria duas funções testAdd2 conflitantes. Não diferencie funções acrescentando números no final, caso pretenda usar o PHPUnit em mais de uma função como essa. Consulte a link:http://www.phpunit.de/ticket/701[+documentação do PHPUnit+].
image::images/editor-bar-after.png[]
-5. Na Barra do Editor, clique em Relatório... O relatório de Cobertura de Código será aberto, mostrando os resultados de todos os testes executados em seu projeto. Os botões no relatório permitem limpar os resultados, reexecutar todos os testes ou desativar a cobertura de código (clique em Concluído).
+
+
+[start=5]
+. Na Barra do Editor, clique em Relatório... O relatório de Cobertura de Código será aberto, mostrando os resultados de todos os testes executados em seu projeto. Os botões no relatório permitem limpar os resultados, reexecutar todos os testes ou desativar a cobertura de código (clique em Concluído).
+
image::images/code-coverage-report.png[]
-6. Você pode adicionar outra classe ao seu projeto, deletar e recriar os arquivos de teste e examinar novamente o relatório de cobertura de código. Sua nova classe será listada. No relatório a seguir, a classe ``Calculator`` tem novamente uma função que não está incluída nos testes.
+
+
+[start=6]
+. Você pode adicionar outra classe ao seu projeto, deletar e recriar os arquivos de teste e examinar novamente o relatório de cobertura de código. Sua nova classe será listada. No relatório a seguir, a classe ``Calculator`` tem novamente uma função que não está incluída nos testes.
+
image::images/code-coverage-report2.png[]
@@ -259,10 +306,19 @@ No IDE, você pode selecionar as configurações personalizadas a seguir no seu
*Para definir uma configuração específica de projeto:*
1. Clique com o botão direito do mouse no nó do projeto ou no nó Arquivos de Teste do projeto e selecione Propriedades. Isso abre a caixa de diálogo Propriedades.
+
image::images/project-ctxmenu.png[]
-2. Selecione a categoria PHPUnit. Uma caixa de diálogo será aberta, na qual você pode selecionar um arquivo bootstrap personalizado, um arquivo de configuração XML ou um arquivo de conjunto de testes.
+
+
+[start=2]
+. Selecione a categoria PHPUnit. Uma caixa de diálogo será aberta, na qual você pode selecionar um arquivo bootstrap personalizado, um arquivo de configuração XML ou um arquivo de conjunto de testes.
+
image::images/proj-properties.png[]
-3. Se não estiver familiarizado com a estrutura dos arquivos bootstrap ou de configuração XML, você poderá usar o NetBeans IDE para gerar um esqueleto para você. Você também pode localizar instruções sobre como utilizar a caixa de diálogo clicando em Ajuda
+
+
+[start=3]
+. Se não estiver familiarizado com a estrutura dos arquivos bootstrap ou de configuração XML, você poderá usar o NetBeans IDE para gerar um esqueleto para você. Você também pode localizar instruções sobre como utilizar a caixa de diálogo clicando em Ajuda
+
image::images/proj-properties-selected.png[]
A _opção bootstrap_ é necessária em projetos que utilizam um carregador de classe personalizado, por exemplo, implementando a função mágica ``__autoload()`` . Você também pode utilizar a opção bootstrap se for necessário incluir um arquivo com antecedência, como um arquivo que defina as constantes globais utilizadas por várias classes no projeto.
@@ -285,14 +341,28 @@ O NetBeans IDE tem um plug-in que inclui um servidor Selenium. Com esse plug-in,
*Para executar testes Selenium no PHP:*
+
1. Abra um prompt de comando e execute o comando ``pear install Testing_Selenium-beta`` . É preciso ter `` PHP_HOME/php/PEAR`` em seu Caminho. Se o comando obtiver êxito, o prompt exibirá ``install ok: channel://pear.php.net/Testing_Selenium-0.4.3`` .
-2. No IDE, abra Ferramentas > Plug-ins e instale o Módulo Selenium para PHP.
-3. Na janela Projetos, clique com o botão direito do mouse no nó do projeto Calculador. Selecione Novo > Outro. O Assistente de Novo Arquivo será aberto. Selecione Selenium e clique em Próximo.
+
+[start=2]
+. No IDE, abra Ferramentas > Plug-ins e instale o Módulo Selenium para PHP.
+
+[start=3]
+. Na janela Projetos, clique com o botão direito do mouse no nó do projeto Calculador. Selecione Novo > Outro. O Assistente de Novo Arquivo será aberto. Selecione Selenium e clique em Próximo.
+
image::images/new-selenium.png[]
-4. Na primeira vez que você cria um teste Selenium, será exibida uma caixa de diálogo solicitando que você defina um diretório para os arquivos de teste Selenium. Esse diretório deverá ser separado do diretório dos arquivos de teste PHPUnit. Caso contrário, os testes Selenium serão executados cada vez que você executar testes de unidade. A execução de testes funcionais como o Selenium, normalmente leva mais tempo do que a execução de testes de unidade, portanto, você provavelmente não de [...]
-5. Aceite os defaults na página Nome e Localização e clique em Finalizar. O novo arquivo de teste Selenium será aberto no editor e aparecerá na janela Projetos.
+
+[start=4]
+. Na primeira vez que você cria um teste Selenium, será exibida uma caixa de diálogo solicitando que você defina um diretório para os arquivos de teste Selenium. Esse diretório deverá ser separado do diretório dos arquivos de teste PHPUnit. Caso contrário, os testes Selenium serão executados cada vez que você executar testes de unidade. A execução de testes funcionais como o Selenium, normalmente leva mais tempo do que a execução de testes de unidade, portanto, você provavelmente não des [...]
+
+[start=5]
+. Aceite os defaults na página Nome e Localização e clique em Finalizar. O novo arquivo de teste Selenium será aberto no editor e aparecerá na janela Projetos.
+
image::images/selenium-test-in-project.png[]
-6. O item Executar Testes Selenium está agora adicionado ao menu de contexto do projeto. Clique nesse item e os resultados do teste Selenium serão exibidos na janela Resultados do Teste, da mesma forma que os resultados de testes PHPUnit.
+
+
+[start=6]
+. O item Executar Testes Selenium está agora adicionado ao menu de contexto do projeto. Clique nesse item e os resultados do teste Selenium serão exibidos na janela Resultados do Teste, da mesma forma que os resultados de testes PHPUnit.
[[more-exercises]]
diff --git a/netbeans.apache.org/src/content/kb/docs/php/phpunit_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/phpunit_ru.asciidoc
index 83ef1ce..54ce2b0 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/phpunit_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/phpunit_ru.asciidoc
@@ -33,10 +33,6 @@ IDE NetBeans для PHP поддерживает автоматические т
IDE NetBeans также поддерживает переносимую платформу тестирования Selenium в сочетании с PHPUnit. Подключаемый модуль Selenium доступен из центра обновления. При установке этот подключаемый модуль добавляет сервер Selenium к зарегистрированным серверам среды IDE, а также добавляет параметры тестирования Selenium к меню PHP.
-
-image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой страницы применимо к IDE NetBeans 7.2, 7.3, 7.4 и 8.0"]
-
-
*Для работы с этим учебным курсом требуется следующее программное обеспечение и ресурсы.*
|===
@@ -62,6 +58,7 @@ image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой
Чтобы проверить, распознает ли среда IDE NetBeans установочный комплект PHPUnit, откройте "Сервис" > "Параметры" (в ОС Mac откройте "Параметры NetBeans") и просмотрите окно "PHP". Откройте вкладку "Модульное тестирование". Должны отобразиться пути к сценариям PHPUnit и генератору схемы. Если сценарий отсутствует, щелкните 'Поиск' рядом с пустым полем. IDE выполнит поиск сценария в локальной системе. В качестве альтернативы можно нажать кнопку "Обзор" и выполнить поиск сценария.
+
image::images/unittesting-options.png[]
@@ -87,7 +84,9 @@ class Calculator
}
?>
----
-2. Добавьте блок комментариев с link:http://sebastian-bergmann.de/archives/628-Improved-Skeleton-Generator-in-PHPUnit-3.html[+аннотацией @assert+], а также пример входных и выходных данных. Обратите внимание – в этот пример включено одно неверное подтверждение.
+
+[start=2]
+. Добавьте блок комментариев с link:http://sebastian-bergmann.de/archives/628-Improved-Skeleton-Generator-in-PHPUnit-3.html[+аннотацией @assert+], а также пример входных и выходных данных. Обратите внимание – в этот пример включено одно неверное подтверждение.
[source,php]
----
@@ -110,24 +109,41 @@ class Calculator
?>
----
-*Примечание.* Можно использовать завершение кода аннотаций для добавления аннотаций `@assert`. Для перемещения между параметрами используйте клавишу табуляции, или нажмите Enter после ввода значения параметра.
+NOTE: Можно использовать завершение кода аннотаций для добавления аннотаций `@assert`. Для перемещения между параметрами используйте клавишу табуляции, или нажмите Enter после ввода значения параметра.
+
image::images/assert-cc.png[]image::images/assert-cc-complete.png[]
-3. В окне "Проекты" правой кнопкой мыши щелкните узел Calculator.php и выберите команду "Сервис" > "Создать тесты PHPUnit". Обратите внимание на то, что тесты для всех файлов в проекте можно создавать в контекстном меню для узла "Исходные файлы".
+
+
+[start=3]
+. В окне "Проекты" правой кнопкой мыши щелкните узел Calculator.php и выберите команду "Сервис" > "Создать тесты PHPUnit". Обратите внимание на то, что тесты для всех файлов в проекте можно создавать в контекстном меню для узла "Исходные файлы".
+
+
image::images/create-tests.png[]
-4. При первом создании тестов в диалоговом окне выводится вопрос о каталоге, в котором следует сохранить файлы тестов. В этом примере функция "Обзор" используется для создания папки ``tests`` .
+
+
+[start=4]
+. При первом создании тестов в диалоговом окне выводится вопрос о каталоге, в котором следует сохранить файлы тестов. В этом примере функция "Обзор" используется для создания папки ``tests`` .
+
+
image::images/test-directory.png[]
-*Примечание.* Пользователи могут написать для проекта несколько тестов вручную. Если создано несколько тестов, вы можете отсортировать их в подпапки каталога файлов тестов, такие как "Важные" или "Быстрые". Тесты можно запустить во вложенной папке, щелкнув правой кнопкой мыши эту папку и выбрав 'Выполнить тесты'.
+NOTE: Пользователи могут написать для проекта несколько тестов вручную. Если создано несколько тестов, вы можете отсортировать их в подпапки каталога файлов тестов, такие как "Важные" или "Быстрые". Тесты можно запустить во вложенной папке, щелкнув правой кнопкой мыши эту папку и выбрав 'Выполнить тесты'.
+
image::images/test-in-folder.png[]
-5. В среде IDE в файле с именем CalculatorTest.php создается базовый класс, который отображается в окне "Проекты" и открывается в редакторе.
+
+
+[start=5]
+. В среде IDE в файле с именем CalculatorTest.php создается базовый класс, который отображается в окне "Проекты" и открывается в редакторе.
+
+
image::images/test-class-in-project.png[]
Обратите внимание на то, что тест создается для каждой аннотации ``@assert`` .
-[source,java]
+[source,php]
----
/**
@@ -141,11 +157,16 @@ image::images/test-class-in-project.png[]
);
}
----
-6. Можно выполнить тестирование отдельного файла или целого проекта. Для тестирования проекта щелкните правой кнопкой мыши родительский узел проекта и выберите команду "Тестировать" или нажмите сочетание клавиш ALT+F6. Для тестирования файла Calculator.php щелкните правой кнопкой узел файла и выберите 'Тестировать' или нажмите Ctrl-F6/⌘-F6. В этом примере существует только один класс в одном файле, так что результаты являются идентичными. Среда IDE выполняет тесты и отображает результаты [...]
+
+[start=6]
+. Можно выполнить тестирование отдельного файла или целого проекта. Для тестирования проекта щелкните правой кнопкой мыши родительский узел проекта и выберите команду "Тестировать" или нажмите сочетание клавиш ALT+F6. Для тестирования файла Calculator.php щелкните правой кнопкой узел файла и выберите 'Тестировать' или нажмите Ctrl-F6/⌘-F6. В этом примере существует только один класс в одном файле, так что результаты являются идентичными. Среда IDE выполняет тесты и отображает результаты [...]
+
+
image::images/test-results-narrow.png[]
Более подробная текстовая версия результатов отображается в окне "Вывод".
+
image::images/test-result-output.png[]
@@ -161,12 +182,25 @@ image::images/test-result-output.png[]
1. В окне "Проекты" правой кнопкой мыши щелкните узел "Калькулятор" и выберите "Свойства". Откроется раздел "Свойства проекта".
2. В разделе "Свойства проекта" выберите категорию PhpUnit. Выберите "Запрос групп тестирования перед выполнением тестов". Нажмите кнопку "ОК".
+
image::images/test-group-properties.png[]
-3. Откройте файл ``CalculatorTest.php`` в редакторе.
-4. Для методов ``testAdd`` , ``testAdd3`` и ``testAdd5`` добавьте аннотацию ``@group production`` .
+
+
+[start=3]
+. Откройте файл ``CalculatorTest.php`` в редакторе.
+
+[start=4]
+. Для методов ``testAdd`` , ``testAdd3`` и ``testAdd5`` добавьте аннотацию ``@group production`` .
+
image::images/production-group-annotation.png[]
-5. Для методов ``testAdd2`` и ``testAdd4`` добавьте аннотации ``@group production`` и ``@group development`` . image::images/production-development-group-code.png[]
-6. Правой кнопкой мыши щелкните узел ``Calculator.php`` и выберите "Тестировать". Откроется диалоговое окно выбора групп тестирования для выполнения. Выберите "разработка" и нажмите клавишу "ОК". Среда IDE выполняет только те тесты, которые имеют аннотацию ``@group development`` .
+
+
+[start=5]
+. Для методов ``testAdd2`` и ``testAdd4`` добавьте аннотации ``@group production`` и ``@group development`` . image:images/production-development-group-code.png[]
+
+[start=6]
+. Правой кнопкой мыши щелкните узел ``Calculator.php`` и выберите "Тестировать". Откроется диалоговое окно выбора групп тестирования для выполнения. Выберите "разработка" и нажмите клавишу "ОК". Среда IDE выполняет только те тесты, которые имеют аннотацию ``@group development`` .
+
image::images/select-test-group.png[]
Дополнительные сведения о группах тестов PhpUnit в IDE NetBeans см. IDE NetBeans для публикации в блоге link:http://blogs.oracle.com/netbeansphp/entry/using_phpunit_test_groups[+Использование групп тестов единиц PHP+].
@@ -183,17 +217,19 @@ image::images/select-test-group.png[]
* Текст правой панели со ссылками на строки кода теста со сбоем
* Текст всплывающей подсказки, отображающийся при наведении курсора на тест со сбоем в панели пользовательского интерфейса
+
image::images/test-results-tooltip.png[]
На левой стороне окна "Результаты теста" расположены следующие кнопки:
-* Повторное выполнение теста image::images/rerun-button.png[];
-* Показать неуспешные тесты image::images/show-failed.png[]
-* Показать успешные тесты image::images/show-passed.png[]
-* Показать завершенные тесты, содержащие ошибки image::images/show-error.png[]
-* Переход между отображением следующего результата теста image::images/next-test-button.png[] или предыдущего результата тестаimage::images/previous-test-button.png[].
+* Повторное выполнение теста image:images/rerun-button.png[];
+* Показать неуспешные тесты image:images/show-failed.png[]
+* Показать успешные тесты image:images/show-passed.png[]
+* Показать завершенные тесты, содержащие ошибки image:images/show-error.png[]
+* Переход между отображением следующего результата теста image:images/next-test-button.png[] или предыдущего результата теста image:images/previous-test-button.png[].
+
+В окне "Вывод" отображаются все выходные данные сценария PHPUnit. Использование этой функции целесообразно, если причину ошибки невозможно установить с помощью информации в окне "Результаты теста". Как и окно "Результаты теста", окно "Вывод" содержит ссылки на строку класса теста с ошибкой. Также включает в себя кнопки на левой стороне для повторного выполнения теста и для открытия окна параметров PHP.image:images/options-link-button.png[]
-В окне "Вывод" отображаются все выходные данные сценария PHPUnit. Использование этой функции целесообразно, если причину ошибки невозможно установить с помощью информации в окне "Результаты теста". Как и окно "Результаты теста", окно "Вывод" содержит ссылки на строку класса теста с ошибкой. Также включает в себя кнопки на левой стороне для повторного выполнения теста и для открытия окна параметров PHP.image::images/options-link-button.png[]
image::images/test-result-output.png[]
@@ -231,18 +267,37 @@ class Calculator {
?>
----
-2. Щелкните узел проекта правой кнопкой мыши. В контекстном меню выберите команду "Охват кода" > "Сбор и отображения охвата кода". По умолчанию панель "Отобразить панель редактора" также выбрана.
+
+[start=2]
+. Щелкните узел проекта правой кнопкой мыши. В контекстном меню выберите команду "Охват кода" > "Сбор и отображения охвата кода". По умолчанию панель "Отобразить панель редактора" также выбрана.
+
image::images/turn-on-code-coverage.png[]
-3. Панель покрытия кода теперь отображается в нижней части редактора. Поскольку тестирование покрытия кода еще не выполнялось, на панели редактора отображается значение покрытия, равное 0%. (Это значение также отображается при нажатии на кнопку "Очистить" для очистки результатов теста).
+
+
+[start=3]
+. Панель покрытия кода теперь отображается в нижней части редактора. Поскольку тестирование покрытия кода еще не выполнялось, на панели редактора отображается значение покрытия, равное 0%. (Это значение также отображается при нажатии на кнопку "Очистить" для очистки результатов теста).
+
image::images/editor-bar-before.png[]
-4. Выберите команду "Тестировать" для тестирования открытого файла или "Все тесты" для запуска всех тестов по проекту. Отобразится окно "Результаты теста". Кроме того, на панели "Покрытие кода" отобразится процент задействованных в тестах операторов исполняемого кода. Задействованный код в окне редактора выделяется зеленым цветом, а незадействованный код – красным цветом.
-*Внимание!*При повторном создании файлов теста ПОСЛЕ добавления функции add2 тесты PHPUnit выполняться не будут. Причиной этого является то, что PHPUnit создает две конфликтующие функции testAdd2. Не разграничивайте функции добавляемыми в конце номерами, если планируете использовать PHPUnit для нескольких подобных функций. См. link:http://www.phpunit.de/ticket/701[+документацию по PHPUnit+].
+
+[start=4]
+. Выберите команду "Тестировать" для тестирования открытого файла или "Все тесты" для запуска всех тестов по проекту. Отобразится окно "Результаты теста". Кроме того, на панели "Покрытие кода" отобразится процент задействованных в тестах операторов исполняемого кода. Задействованный код в окне редактора выделяется зеленым цветом, а незадействованный код – красным цветом.
+
+WARNING: При повторном создании файлов теста ПОСЛЕ добавления функции add2 тесты PHPUnit выполняться не будут. Причиной этого является то, что PHPUnit создает две конфликтующие функции testAdd2. Не разграничивайте функции добавляемыми в конце номерами, если планируете использовать PHPUnit для нескольких подобных функций. См. link:http://www.phpunit.de/ticket/701[+документацию по PHPUnit+].
+
image::images/editor-bar-after.png[]
-5. На панели редактора щелкните элемент "Отчет...". Отобразится отчет "Покрытие кода", в котором будут показаны результаты всех тестов, выполненных для проекта. Кнопки в отчете позволяют очищать результаты, повторно выполнять тесты или отключать покрытие кода (нажмите кнопку "Готово").
+
+
+[start=5]
+. На панели редактора щелкните элемент "Отчет...". Отобразится отчет "Покрытие кода", в котором будут показаны результаты всех тестов, выполненных для проекта. Кнопки в отчете позволяют очищать результаты, повторно выполнять тесты или отключать покрытие кода (нажмите кнопку "Готово").
+
image::images/code-coverage-report.png[]
-6. Разработчик может добавить другой класс в проект, удалить и заново создать файлы теста, а также еще раз изучить отчет о покрытии кода. Будет показан новый класс. В следующем отчете класс ``Calculator`` снова содержит функцию, не включенную в тесты.
+
+
+[start=6]
+. Разработчик может добавить другой класс в проект, удалить и заново создать файлы теста, а также еще раз изучить отчет о покрытии кода. Будет показан новый класс. В следующем отчете класс ``Calculator`` снова содержит функцию, не включенную в тесты.
+
image::images/code-coverage-report2.png[]
@@ -259,10 +314,19 @@ image::images/code-coverage-report2.png[]
*Настройка конфигурации, связанной с проектом.*
1. Щелкните правой кнопкой мыши узел проекта или узел проекта "Файлы тестов", а затем выберите пункт меню "Свойства". В результате откроется диалоговое окно "Свойства".
+
image::images/project-ctxmenu.png[]
-2. Выберите в нем категорию "PHPUnit". Откроется диалоговое окно, в котором можно выбрать особый файл начальной загрузки, конфигурацию XML, сценарий PHPUnit или файл набора тестов.
+
+
+[start=2]
+. Выберите в нем категорию "PHPUnit". Откроется диалоговое окно, в котором можно выбрать особый файл начальной загрузки, конфигурацию XML, сценарий PHPUnit или файл набора тестов.
+
image::images/proj-properties.png[]
-3. Пользователи, не знакомые со структурой начальной нагрузки или файлами конфигурации XML можно использовать IDE NetBeans для создания основы. Инструкции по использованию диалогового доступны при выборе 'Справка'.
+
+
+[start=3]
+. Пользователи, не знакомые со структурой начальной нагрузки или файлами конфигурации XML можно использовать IDE NetBeans для создания основы. Инструкции по использованию диалогового доступны при выборе 'Справка'.
+
image::images/proj-properties-selected.png[]
_Вариант начальной загрузки_ требуется для проектов, в которых используется собственный загрузчик классов, например, посредством реализации магической функции ``__autoload()`` . Вариант начальной загрузки используется также при необходимости включения файла, содержащего, например, глобальные константы, которые используются несколькими классами в проекте, в будущем.
@@ -288,11 +352,21 @@ Selenium – это переносимая платформа тестирова
1. Откройте командную строку и запустите команду ``pear install Testing_Selenium-beta`` . `` PHP_HOME/php/PEAR`` должен быть добавлен к пути. Если команда выполнена успешно, то командная строка отобразит текст ``install ok: channel://pear.php.net/Testing_Selenium-0.4.3`` .
2. В среде IDE откройте меню "Сервис" > "Подключаемые модули" и установите модуль Selenium для PHP.
3. В окне "Проекты" правой кнопкой мыши щелкните узел проекта для проекта Calculator. Выберите команду "Создать" > "Прочие". Откроется мастер создания файла. Выберите параметр "Selenium" и нажмите кнопку "Далее".
+
image::images/new-selenium.png[]
-4. При первом создании теста Selenium будет открыто диалоговое окно, позволяющее установить каталог для файлов теста Selenium. Этот каталог должен отличаться от каталога файлов теста PHPUnit. В противном случае тесты Selenium будут запускаться при каждом запуске модульных тестов. Запуск функциональных тестов вида Selenium обычно занимает больше времени, чем запуск модульных тестов, поэтому их совместный запуск с модульными тестами скорее всего нежелателен.
-5. Примите параметры по умолчанию на странице "Имя и местоположение" и нажмите кнопку "Готово". Новый файл теста Selenium откроется в редакторе и появится в окне "Проекты".
+
+
+[start=4]
+. При первом создании теста Selenium будет открыто диалоговое окно, позволяющее установить каталог для файлов теста Selenium. Этот каталог должен отличаться от каталога файлов теста PHPUnit. В противном случае тесты Selenium будут запускаться при каждом запуске модульных тестов. Запуск функциональных тестов вида Selenium обычно занимает больше времени, чем запуск модульных тестов, поэтому их совместный запуск с модульными тестами скорее всего нежелателен.
+
+[start=5]
+. Примите параметры по умолчанию на странице "Имя и местоположение" и нажмите кнопку "Готово". Новый файл теста Selenium откроется в редакторе и появится в окне "Проекты".
+
image::images/selenium-test-in-project.png[]
-6. Элемент "Выполнить тесты Selenium" добавлен в контекстное меню проекта. Щелкните этот элемент, и результаты теста Selenium отобразятся в окне "Результаты теста", как и для тестов PHPUnit.
+
+
+[start=6]
+. Элемент "Выполнить тесты Selenium" добавлен в контекстное меню проекта. Щелкните этот элемент, и результаты теста Selenium отобразятся в окне "Результаты теста", как и для тестов PHPUnit.
[[more-exercises]]
diff --git a/netbeans.apache.org/src/content/kb/docs/php/phpunit_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/phpunit_zh_CN.asciidoc
index 52c8aa2..622795a 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/phpunit_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/phpunit_zh_CN.asciidoc
@@ -34,9 +34,6 @@
NetBeans IDE 还支持将 Selenium 可移植测试框架与 PHPUnit 结合使用。Selenium 插件可以从更新中心获取。安装此插件会将 Selenium 服务器添加到 IDE 的已注册服务器中，并将 Selenium 测试选项添加到 PHP 菜单。
-image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 NetBeans IDE 7.2、7.3、7.4 和 8.0"]
-
-
*要学习本教程，您需要具备以下软件和资源。*
|===
@@ -87,7 +84,9 @@ class Calculator
}
?>
----
-2. 添加一个包含 link:http://sebastian-bergmann.de/archives/628-Improved-Skeleton-Generator-in-PHPUnit-3.html[+@assert 标注+]以及一些样例输入和输出的注释块。请注意，本示例中包括一个错误的断言。
+
+[start=2]
+. 添加一个包含 link:http://sebastian-bergmann.de/archives/628-Improved-Skeleton-Generator-in-PHPUnit-3.html[+@assert 标注+]以及一些样例输入和输出的注释块。请注意，本示例中包括一个错误的断言。
[source,php]
----
@@ -112,22 +111,36 @@ class Calculator
*注：*您可以使用标注代码完成来添加 `@assert` 标注。使用 Tab 键在参数之间导航，或者在填写参数值后单击 Enter。
-image::images/assert-cc.png[]image::images/assert-cc-complete.png[]
-3. 在 "Projects"（项目）窗口中，右键单击 "Calculator.php" 节点，然后选择 "Tools"（工具）> "Create PHPUnit Tests"（创建 PHPUnit 测试）。请注意，您可以在 "Source Files"（源文件）节点的上下文菜单中为项目中的所有文件创建测试。
+image::images/assert-cc.png[]
+
+image::images/assert-cc-complete.png[]
+
+
+[start=3]
+. 在 "Projects"（项目）窗口中，右键单击 "Calculator.php" 节点，然后选择 "Tools"（工具）> "Create PHPUnit Tests"（创建 PHPUnit 测试）。请注意，您可以在 "Source Files"（源文件）节点的上下文菜单中为项目中的所有文件创建测试。
+
image::images/create-tests.png[]
-4. 第一次创建测试时，将会打开一个对话框，询问您要存储测试文件的目录。在本示例中，使用“浏览”功能创建了 ``tests`` 目录。
+
+
+[start=4]
+. 第一次创建测试时，将会打开一个对话框，询问您要存储测试文件的目录。在本示例中，使用“浏览”功能创建了 ``tests`` 目录。
+
image::images/test-directory.png[]
*注：*您可以手动为一个项目编写多个测试。如果编写多个测试，可以将它们分类到测试文件目录的子文件夹中，例如 "important" 或 "quick"。然后，可以通过右键单击某个子文件夹并选择 "Run Tests"（运行测试），来运行该文件夹中的测试。
image::images/test-in-folder.png[]
-5. IDE 在一个名为 CalculatorTest.php 的文件中生成框架测试类，在 "Projects"（项目）窗口中会显示该文件，并在编辑器中将其打开。
+
+
+[start=5]
+. IDE 在一个名为 CalculatorTest.php 的文件中生成框架测试类，在 "Projects"（项目）窗口中会显示该文件，并在编辑器中将其打开。
+
image::images/test-class-in-project.png[]
请注意，将为每个 ``@assert`` 标注创建一个测试。
-[source,java]
+[source,php]
----
/**
@@ -141,7 +154,10 @@ image::images/test-class-in-project.png[]
);
}
----
-6. 您既可以测试单个文件，也可以测试整个项目。要测试项目，请右键单击项目的父节点，然后选择 "Test"（测试）或按 Alt-F6 组合键。要测试 Calculator.php 文件，请右键单击该文件的节点，然后选择 "Test"（测试），或者按 Ctrl-F6/⌘-F6 组合键。本示例只有一个文件，且该文件中只有一个类，因此两种测试结果相同。IDE 会运行测试并在 "Test Results"（测试结果）窗口中显示结果。
+
+[start=6]
+. 您既可以测试单个文件，也可以测试整个项目。要测试项目，请右键单击项目的父节点，然后选择 "Test"（测试）或按 Alt-F6 组合键。要测试 Calculator.php 文件，请右键单击该文件的节点，然后选择 "Test"（测试），或者按 Ctrl-F6/⌘-F6 组合键。本示例只有一个文件，且该文件中只有一个类，因此两种测试结果相同。IDE 会运行测试并在 "Test Results"（测试结果）窗口中显示结果。
+
image::images/test-results-narrow.png[]
测试结果的更详细文本版本会显示在 "Output"（输出）窗口中。
@@ -161,12 +177,25 @@ image::images/test-result-output.png[]
1. 在 "Projects"（项目）窗口中，右键单击 "Calculator" 节点，然后选择 "Properties"（属性）。"Project Properties"（项目属性）打开。
2. 在 "Project Properties"（项目属性）中，选择 "PhpUnit" 类别。选择 "Ask for Test Groups Before Running Tests"（在运行测试之前询问测试组）。单击 "OK"（确定）。
+
image::images/test-group-properties.png[]
-3. 在编辑器中打开 ``CalculatorTest.php`` 。
-4. 为 ``testAdd`` 、 ``testAdd3`` 和 ``testAdd5`` 方法添加标注 ``@group production`` 。
+
+
+[start=3]
+. 在编辑器中打开 ``CalculatorTest.php`` 。
+
+[start=4]
+. 为 ``testAdd`` 、 ``testAdd3`` 和 ``testAdd5`` 方法添加标注 ``@group production`` 。
+
image::images/production-group-annotation.png[]
-5. 对于方法 ``testAdd2`` 和 ``testAdd4`` ，添加标注 ``@group production`` 和 ``@group development`` 。image::images/production-development-group-code.png[]
-6. 右键单击 ``Calculator.php`` 节点，然后选择 "Test"（测试）。此时将会打开一个对话框，询问您要运行哪些测试组。选择 "development"，然后单击 "OK"（确定）。IDE 只运行使用 ``@group development`` 标注的测试。
+
+
+[start=5]
+. 对于方法 ``testAdd2`` 和 ``testAdd4`` ，添加标注 ``@group production`` 和 ``@group development`` 。image:images/production-development-group-code.png[]
+
+[start=6]
+. 右键单击 ``Calculator.php`` 节点，然后选择 "Test"（测试）。此时将会打开一个对话框，询问您要运行哪些测试组。选择 "development"，然后单击 "OK"（确定）。IDE 只运行使用 ``@group development`` 标注的测试。
+
image::images/select-test-group.png[]
有关 NetBeans IDE 中 PhpUnit 测试组的详细信息，请参见 "NetBeans IDE for PHP" 博客帖子：link:http://blogs.oracle.com/netbeansphp/entry/using_phpunit_test_groups[+Using PHP Unit Test Groups+]（使用 PHP 单元测试组）。
@@ -187,13 +216,13 @@ image::images/test-results-tooltip.png[]
"Test Results"（测试结果）窗口在左侧包括以下按钮：
-* 重新运行测试按钮 image::images/rerun-button.png[]
-* 显示失败的测试 image::images/show-failed.png[]
-* 显示通过的测试 image::images/show-passed.png[]
-* 显示通过但出错的测试 image::images/show-error.png[]
-* 导航至下一个测试结果的按钮 image::images/next-test-button.png[]，以及导航至上一个测试结果的按钮 image::images/previous-test-button.png[]
+* 重新运行测试按钮 image:images/rerun-button.png[]
+* 显示失败的测试 image:images/show-failed.png[]
+* 显示通过的测试 image:images/show-passed.png[]
+* 显示通过但出错的测试 image:images/show-error.png[]
+* 导航至下一个测试结果的按钮 image:images/next-test-button.png[]，以及导航至上一个测试结果的按钮 image:images/previous-test-button.png[]
-"Output"（输出）窗口显示 PHPUnit 脚本的完整输出。当您无法通过 "Test Results"（测试结果）窗口中的信息找出错误原因时，该窗口会非常有用。与 "Test Results"（测试结果）窗口类似，"Output"（输出）窗口包括指向失败的测试类行的链接。它还在左侧包括用于重新运行测试和用于打开 "PHP Options"（PHP 选项）窗口的按钮。image::images/options-link-button.png[]
+"Output"（输出）窗口显示 PHPUnit 脚本的完整输出。当您无法通过 "Test Results"（测试结果）窗口中的信息找出错误原因时，该窗口会非常有用。与 "Test Results"（测试结果）窗口类似，"Output"（输出）窗口包括指向失败的测试类行的链接。它还在左侧包括用于重新运行测试和用于打开 "PHP Options"（PHP 选项）窗口的按钮。image:images/options-link-button.png[]
image::images/test-result-output.png[]
@@ -231,18 +260,36 @@ class Calculator {
?>
----
-2. 右键单击项目节点。从上下文菜单中，选择 "Code Coverage"（代码覆盖率）> "Collect and Display Code Coverage"（收集并显示代码覆盖率）。默认情况下，"Show Editor Bar"（显示编辑器栏）也会处于选定状态。
+
+[start=2]
+. 右键单击项目节点。从上下文菜单中，选择 "Code Coverage"（代码覆盖率）> "Collect and Display Code Coverage"（收集并显示代码覆盖率）。默认情况下，"Show Editor Bar"（显示编辑器栏）也会处于选定状态。
+
image::images/turn-on-code-coverage.png[]
-3. 现在，编辑器会在底部显示代码覆盖率编辑器栏。由于尚未测试代码覆盖率，因此编辑器栏报告覆盖率为 0%。（在单击 "Clear"（清除）以清除测试结果后，编辑器栏也会显示覆盖率为 0%。）
+
+
+[start=3]
+. 现在，编辑器会在底部显示代码覆盖率编辑器栏。由于尚未测试代码覆盖率，因此编辑器栏报告覆盖率为 0%。（在单击 "Clear"（清除）以清除测试结果后，编辑器栏也会显示覆盖率为 0%。）
+
image::images/editor-bar-before.png[]
-4. 单击 "Test"（测试）以测试打开的文件，或单击 "All Tests"（所有测试）以运行项目的所有测试。此时显示 "Test Results"（测试结果）。此外，"Code Coverage"（代码覆盖率）栏会告知您测试所覆盖的可执行代码语句百分比。在编辑器窗口中，覆盖的代码将以绿色突出显示，未覆盖的代码将以红色突出显示。
+
+
+[start=4]
+. 单击 "Test"（测试）以测试打开的文件，或单击 "All Tests"（所有测试）以运行项目的所有测试。此时显示 "Test Results"（测试结果）。此外，"Code Coverage"（代码覆盖率）栏会告知您测试所覆盖的可执行代码语句百分比。在编辑器窗口中，覆盖的代码将以绿色突出显示，未覆盖的代码将以红色突出显示。
*警告：*如果在添加 add2 函数之后重新生成测试文件，则不会运行 PHPUnit 测试。这是因为 PHPUnit 创建了两个冲突的 testAdd2 函数。如果您计划对多个此类函数使用 PHPUnit，则不要通过在末尾附加数字的方式来区分函数。请参见 link:http://www.phpunit.de/ticket/701[+PHPUnit 文档+]。
image::images/editor-bar-after.png[]
-5. 在编辑器栏中，单击 "Report..."（报告...）。代码覆盖率报告打开，其中显示了对项目运行的所有测试的结果。使用报告中的按钮，您可以清除结果，再次运行所有测试或取消激活代码覆盖率（单击 "Done"（完成））。
+
+
+[start=5]
+. 在编辑器栏中，单击 "Report..."（报告...）。代码覆盖率报告打开，其中显示了对项目运行的所有测试的结果。使用报告中的按钮，您可以清除结果，再次运行所有测试或取消激活代码覆盖率（单击 "Done"（完成））。
+
image::images/code-coverage-report.png[]
-6. 您可以在项目中添加其他类；删除测试文件，然后重新创建测试文件；接下来，再次查看代码覆盖率报告。此时将会列出新类。在下面的报告中， ``Calculator`` 类又有一个函数未包括在测试中。
+
+
+[start=6]
+. 您可以在项目中添加其他类；删除测试文件，然后重新创建测试文件；接下来，再次查看代码覆盖率报告。此时将会列出新类。在下面的报告中， ``Calculator`` 类又有一个函数未包括在测试中。
+
image::images/code-coverage-report2.png[]
@@ -259,10 +306,19 @@ image::images/code-coverage-report2.png[]
*要设置项目特定的配置，请执行以下操作：*
1. 右键单击项目节点或项目的 "Test Files"（测试文件）节点，然后选择 "Properties"（属性）。这会打开 "Properties"（属性）对话框。
+
image::images/project-ctxmenu.png[]
-2. 选择 PHPUnit 类别。此时将打开一个对话框，可以在其中选择定制引导、XML 配置、PHPUnit 脚本或测试套件文件。
+
+
+[start=2]
+. 选择 PHPUnit 类别。此时将打开一个对话框，可以在其中选择定制引导、XML 配置、PHPUnit 脚本或测试套件文件。
+
image::images/proj-properties.png[]
-3. 如果您不熟悉引导或 XML 配置文件的结构，可以使用 NetBeans IDE 生成框架。您还可以通过单击 "Help"（帮助）查找有关使用该对话框的说明。
+
+
+[start=3]
+. 如果您不熟悉引导或 XML 配置文件的结构，可以使用 NetBeans IDE 生成框架。您还可以通过单击 "Help"（帮助）查找有关使用该对话框的说明。
+
image::images/proj-properties-selected.png[]
使用定制类加载器的项目需要_引导选项_，例如，通过实现 Magic 函数 ``__autoload()`` 。如果需要预先包含一个文件（如定义项目中的多个类所使用的全局常量的文件），则也需要使用引导选项。
@@ -286,13 +342,27 @@ NetBeans IDE 具有包含 Selenium 服务器的插件。通过此插件，您可
*对 PHP 运行 Selenium 测试：*
1. 打开命令提示符，然后运行 ``pear install Testing_Selenium-beta`` 命令。您需要在 Path 变量中包含 ``PHP_HOME/php/PEAR`` 。如果成功运行该命令，则将显示以下提示： ``install ok: channel://pear.php.net/Testing_Selenium-0.4.3`` 。
-2. 在 IDE 中，打开 "Tools"（工具）> "Plugins"（插件），然后安装 "Selenium Module for PHP"。
-3. 在 "Projects"（项目）窗口中，右键单击 Calculator 项目的节点。选择 "New"（新建）> "Other"（其他）。此时将打开新建文件向导。选择 "Selenium"，然后单击 "Next"（下一步）。
+
+[start=2]
+. 在 IDE 中，打开 "Tools"（工具）> "Plugins"（插件），然后安装 "Selenium Module for PHP"。
+
+[start=3]
+. 在 "Projects"（项目）窗口中，右键单击 Calculator 项目的节点。选择 "New"（新建）> "Other"（其他）。此时将打开新建文件向导。选择 "Selenium"，然后单击 "Next"（下一步）。
+
image::images/new-selenium.png[]
-4. 第一次创建 Selenium 测试时，将会打开一个对话框，要求您设置 Selenium 测试文件的目录。此目录应不同于 PHPUnit 测试文件的目录。否则，每次运行单元测试时，Selenium 测试都会运行。运行 Selenium 之类的功能测试通常比运行单元测试所花费的时间长，因此在每次运行单元测试时，您可能不会希望运行这些测试。
-5. 接受 "Name and Location"（名称和位置）页中的默认设置，然后单击 "Finish"（完成）。新 Selenium 测试文件在编辑器中打开，并在 "Projects"（项目）窗口中显示。
+
+
+[start=4]
+. 第一次创建 Selenium 测试时，将会打开一个对话框，要求您设置 Selenium 测试文件的目录。此目录应不同于 PHPUnit 测试文件的目录。否则，每次运行单元测试时，Selenium 测试都会运行。运行 Selenium 之类的功能测试通常比运行单元测试所花费的时间长，因此在每次运行单元测试时，您可能不会希望运行这些测试。
+
+[start=5]
+. 接受 "Name and Location"（名称和位置）页中的默认设置，然后单击 "Finish"（完成）。新 Selenium 测试文件在编辑器中打开，并在 "Projects"（项目）窗口中显示。
+
image::images/selenium-test-in-project.png[]
-6. 现在，"Run Selenium Tests"（运行 Selenium 测试）项已添加到项目的上下文菜单中。单击此项，Selenium 测试结果随即显示在与 PHPUnit 测试相同的 "Test Results"（测试结果）窗口中。
+
+
+[start=6]
+. 现在，"Run Selenium Tests"（运行 Selenium 测试）项已添加到项目的上下文菜单中。单击此项，Selenium 测试结果随即显示在与 PHPUnit 测试相同的 "Test Results"（测试结果）窗口中。
[[more-exercises]]
diff --git a/netbeans.apache.org/src/content/kb/docs/php/project-setup.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/project-setup.asciidoc
index 6b5a2ae..18a6adf 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/project-setup.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/project-setup.asciidoc
@@ -80,13 +80,13 @@ The document root is the folder where the local web server looks for files to op
A copy of the source files must be kept in a subfolder of the document root. However, you can have your Sources Folder in a different location than the document root and copy source files from this location to the document root. See <<copy-sources,Specifying the Run Configuration>>.
[start=4]
-4. From the Default Encoding dropdown list, choose the default encoding for your project.
-5. If you want to store NetBeans metadata in a different location than your source files, select "Put NetBeans metadata into a separate directory." For example, you might want to store your sources in your document root but the NetBeans metadata in your NetBeansProjects directory.
+. From the Default Encoding dropdown list, choose the default encoding for your project.
+. If you want to store NetBeans metadata in a different location than your source files, select "Put NetBeans metadata into a separate directory." For example, you might want to store your sources in your document root but the NetBeans metadata in your NetBeansProjects directory.
image::images/new-php-project-m1.png[]
[start=6]
-6. Click Next. The Run Configuration panel opens.
+. Click Next. The Run Configuration panel opens.
=== Importing Existing Local Source Files into a Project
@@ -98,13 +98,13 @@ image::images/new-php-project-m1.png[]
NOTE: If you are going to run the <<localServer,project on a local web server>>, do not forget to specify <<copyFilesFromSourcesFolder,copying the source files>> to it.
[start=4]
-4. From the Default Encoding dropdown list, choose the default encoding for your project.
-5. If you want to store NetBeans metadata in a different location than your source files, select "Put NetBeans metadata into a separate directory." For example, you might want to store your sources in your document root but the NetBeans metadata in your NetBeansProjects directory.
+. From the Default Encoding dropdown list, choose the default encoding for your project.
+. If you want to store NetBeans metadata in a different location than your source files, select "Put NetBeans metadata into a separate directory." For example, you might want to store your sources in your document root but the NetBeans metadata in your NetBeansProjects directory.
image::images/new-php-project-with-ssources.png[]
[start=6]
-6. Click Next. The Run Configuration panel opens.
+. Click Next. The Run Configuration panel opens.
=== Importing Existing Remote Source Files into a Project
@@ -116,8 +116,8 @@ image::images/new-php-project-with-ssources.png[]
The document root is the folder where the local web server looks for files to open in the browser. The document root is specified in the web server link:../../trails/php.html#configuration[+configuration file+]. After installation, the New Project wizard locates the document root and by default specifies the following path: ``<Document Root>\<New PHP Project>`` . Note that it is useful to be able to test the project on a local server.
[start=4]
-4. If you want to store NetBeans metadata in a different location than your source files, select "Put NetBeans metadata into a separate directory." For example, you might want to store your sources in your document root but the NetBeans metadata in your NetBeansProjects directory.
-5. Click Next. The Remote Connection panel opens. The tutorial link:remote-hosting-and-ftp-account.html[+Deploying a PHP Application to a Remote Web Server+] describes how to set up remote connections.
+. If you want to store NetBeans metadata in a different location than your source files, select "Put NetBeans metadata into a separate directory." For example, you might want to store your sources in your document root but the NetBeans metadata in your NetBeansProjects directory.
+. Click Next. The Remote Connection panel opens. The tutorial link:remote-hosting-and-ftp-account.html[+Deploying a PHP Application to a Remote Web Server+] describes how to set up remote connections.
== Specifying the Default Run Configuration of the New Project
@@ -150,12 +150,13 @@ To set up a local web site configuration:
image::images/run-configuration-local-server-project-with-existing-sources.png[]
[start=3]
-3. If you are creating the project from existing sources, you can choose which source file to use as the index file.
-4. To store the project's source files in a different directory than the NetBeans IDE project, select "Copy files from Sources Folder to another location". _If you are creating a project from existing sources, this is a required step, unless the existing sources were already in the web folder of your Apache server._
+. If you are creating the project from existing sources, you can choose which source file to use as the index file.
+. To store the project's source files in a different directory than the NetBeans IDE project, select "Copy files from Sources Folder to another location". _If you are creating a project from existing sources, this is a required step, unless the existing sources were already in the web folder of your Apache server._
The field by default specifies the following path: `` <Document Root>\<New PHP Project>`` . Use the Browse button to specify a different path, if necessary.
The document root is the folder where the web server looks for files to open in the browser. The document root is specified in the web server link:../../trails/php.html#configuration[+configuration file+].
The wizard detects the Apache installation type, either a component or within a package, and provides the path to the default location of the ``htdocs`` folder for the current installation type. Therefore, if you accepted the default settings during the installation of the Apache server or the AMP package, choose the path from the dropdown list.
-5. Click Finish. The IDE creates your PHP project.
+[start=5]
+. Click Finish. The IDE creates your PHP project.
=== Remote Web Site
@@ -170,21 +171,21 @@ See the tutorial link:remote-hosting-and-ftp-account.html[+Deploying a PHP Appli
image::images/project-properties-script.png[]
[start=2]
-2. To specify the location of the PHP engine, click the Configure button next to the Use Default PHP Interpreter box. The PHP Options dialog opens on the General tab.
+. To specify the location of the PHP engine, click the Configure button next to the Use Default PHP Interpreter box. The PHP Options dialog opens on the General tab.
image::images/run-config-script-options-m1.png[]
[start=3]
-3. In the PHP 5 Interpreter field, specify the path to the ``php.exe`` file. Use the Browse or Search... button, if necessary.
-4. To specify how the script execution results will be shown, select the relevant checkbox in the Open Result In area. The following options are available:
+. In the PHP 5 Interpreter field, specify the path to the ``php.exe`` file. Use the Browse or Search... button, if necessary.
+. To specify how the script execution results will be shown, select the relevant checkbox in the Open Result In area. The following options are available:
* Output Window. The results of executing a script will appear in the output window in the bottom of the NetBeans IDE window.
* Web Browser. The default browser window will open with the results of executing a script in the form of an HTML file.
* Editor. The results of executing a script will open as an HTML file in the IDE editor window.
[start=5]
-5. Click OK. The Options dialog box closes and the system returns to the Run Configuration panel.
-6. Add any arguments, such as ``debug=true`` , and any link:http://www.php.net/manual/en/features.commandline.options.php[+PHP command-line options+].
+. Click OK. The Options dialog box closes and the system returns to the Run Configuration panel.
+. Add any arguments, such as ``debug=true`` , and any link:http://www.php.net/manual/en/features.commandline.options.php[+PHP command-line options+].
== Customizing the Project Setup
@@ -204,7 +205,7 @@ On the Sources panel:
image::images/pprop-sources.png[]
[start=4]
-4. To complete the project customization, click OK.
+. To complete the project customization, click OK.
=== Run Configuration
@@ -221,7 +222,7 @@ On the Run Configuration panel, modify the default run configuration and/or defi
image::images/pprop-runconfig.png[]
[start=6]
-6. To complete the project customization, click OK.
+. To complete the project customization, click OK.
=== PHP Include Path
@@ -237,7 +238,7 @@ On the Include Path panel, specify the location of the files that you need to us
image::images/pprop-include-path.png[]
[start=5]
-5. To complete the project customization, click OK.
+. To complete the project customization, click OK.
=== Formatting
@@ -252,14 +253,14 @@ On the Formatting panel, define the formatting style you want to apply to your s
image::images/global-formatting.png[]
[start=3]
-3. From the Language dropdown list, select the language to which the settings should be applied.
-4. From the Categories dropdown list, select the format items to which the setting will be applied.
-5. Set your desired formatting and click OK.
-6. Click the Help button for detailed information.
+. From the Language dropdown list, select the language to which the settings should be applied.
+. From the Categories dropdown list, select the format items to which the setting will be applied.
+. Set your desired formatting and click OK.
+. Click the Help button for detailed information.
==== To define project-specific formatting:
-1. Choose "Use project-specific options". The hidden area displays. image::images/pprop-formatting.png[]
+1. Choose "Use project-specific options". The hidden area displays. image:images/pprop-formatting.png[]
2. From the Language dropdown list, select All Languages or PHP. In this case, All Languages means PHP and all other languages you have in your PHP project.
3. From the Categories dropdown list, select the format items to which the setting will be applied.
4. Set your desired formatting and click OK.
diff --git a/netbeans.apache.org/src/content/kb/docs/php/project-setup_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/project-setup_ja.asciidoc
index 86f98f1..d05496f 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/project-setup_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/project-setup_ja.asciidoc
@@ -31,10 +31,6 @@
このチュートリアルでは、NetBeans IDEでのPHPプロジェクトの設定方法を示します。
-
-image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、NetBeans IDE 7.2、7.3、7.4および8.0に適用されます"]
-
-
*このチュートリアルに従うには、次のソフトウェアとリソースが必要です。*
|===
@@ -82,10 +78,18 @@ PHPプロジェクトを設定するには:
ソース・ファイルのコピーは、ドキュメント・ルートのサブフォルダに保持される必要があります。ただし、ドキュメント・ルート以外の別の場所にソース・フォルダを保持することもでき、この場所からドキュメント・ルートにソース・ファイルをコピーすることもできます。<<copy-sources,実行構成の指定>>を参照してください。
-4. 「デフォルトのエンコーディング」ドロップダウン・リストから、プロジェクトでデフォルトとなるエンコーディングを選択します。
-5. NetBeansのメタデータをソース・ファイル以外の別の場所に保存する場合、「NetBeansのメタデータを別のディレクトリに配置」を選択します。たとえば、ソースはドキュメント・ルートに保存するが、NetBeansのメタデータはNetBeansProjectsディレクトリに保存する場合です。
+
+[start=4]
+. 「デフォルトのエンコーディング」ドロップダウン・リストから、プロジェクトでデフォルトとなるエンコーディングを選択します。
+
+[start=5]
+. NetBeansのメタデータをソース・ファイル以外の別の場所に保存する場合、「NetBeansのメタデータを別のディレクトリに配置」を選択します。たとえば、ソースはドキュメント・ルートに保存するが、NetBeansのメタデータはNetBeansProjectsディレクトリに保存する場合です。
+
image::images/new-php-project-m1.png[]
-6. 「次」をクリックします。「実行構成」パネルが開きます。
+
+
+[start=6]
+. 「次」をクリックします。「実行構成」パネルが開きます。
=== プロジェクトへの既存のローカル・ソース・ファイルのインポート
@@ -93,11 +97,21 @@ image::images/new-php-project-m1.png[]
1. 「プロジェクト」領域で、「既存のソースを使用するPHPアプリケーション」を選択して「次」をクリックします。「新規PHPプロジェクト」>「名前と場所」パネルを開きます。
2. 「プロジェクト名」テキスト・フィールドで、プロジェクトの名前を入力します。
3. 「ソース・フォルダ」フィールドで、ソース・ファイルのインポート元のフォルダを指定します。
-*注意:* <<localServer,プロジェクトをローカルWebサーバー>>で実行する場合は、そのサーバーへの<<copyFilesFromSourcesFolder,ソース・ファイルのコピー>>を指定することを忘れないでください。
-4. 「デフォルトのエンコーディング」ドロップダウン・リストから、プロジェクトでデフォルトとなるエンコーディングを選択します。
-5. NetBeansのメタデータをソース・ファイル以外の別の場所に保存する場合、「NetBeansのメタデータを別のディレクトリに配置」を選択します。たとえば、ソースはドキュメント・ルートに保存するが、NetBeansのメタデータはNetBeansProjectsディレクトリに保存する場合です。
+
+NOTE: <<localServer,プロジェクトをローカルWebサーバー>>で実行する場合は、そのサーバーへの<<copyFilesFromSourcesFolder,ソース・ファイルのコピー>>を指定することを忘れないでください。
+
+
+[start=4]
+. 「デフォルトのエンコーディング」ドロップダウン・リストから、プロジェクトでデフォルトとなるエンコーディングを選択します。
+
+[start=5]
+. NetBeansのメタデータをソース・ファイル以外の別の場所に保存する場合、「NetBeansのメタデータを別のディレクトリに配置」を選択します。たとえば、ソースはドキュメント・ルートに保存するが、NetBeansのメタデータはNetBeansProjectsディレクトリに保存する場合です。
+
image::images/new-php-project-with-ssources.png[]
-6. 「次」をクリックします。「実行構成」パネルが開きます。
+
+
+[start=6]
+. 「次」をクリックします。「実行構成」パネルが開きます。
=== プロジェクトへの既存のリモート・ソース・ファイルのインポート
@@ -108,8 +122,12 @@ image::images/new-php-project-with-ssources.png[]
ドキュメント・ルートは、ローカルWebサーバーがブラウザで開くファイルを探すフォルダです。ドキュメント・ルートは、Webサーバーのlink:../../trails/php.html#configuration[+構成ファイル+]で指定されています。インストール後、新規プロジェクト・ウィザードによってドキュメント・ルートが検索され、デフォルトでは、 ``<ドキュメント・ルート>\<新規PHPプロジェクト>`` というパスが指定されます。プロジェクトをローカル・サーバーでテストできることは便利です。
-4. NetBeansのメタデータをソース・ファイル以外の別の場所に保存する場合、「NetBeansのメタデータを別のディレクトリに配置」を選択します。たとえば、ソースはドキュメント・ルートに保存するが、NetBeansのメタデータはNetBeansProjectsディレクトリに保存する場合です。
-5. 「次」をクリックします。「リモート接続」パネルが開きます。チュートリアルのlink:remote-hosting-and-ftp-account.html[+リモートWebサーバーへのPHPアプリケーションのデプロイ+]に、リモート接続の設定方法が説明されています。
+
+[start=4]
+. NetBeansのメタデータをソース・ファイル以外の別の場所に保存する場合、「NetBeansのメタデータを別のディレクトリに配置」を選択します。たとえば、ソースはドキュメント・ルートに保存するが、NetBeansのメタデータはNetBeansProjectsディレクトリに保存する場合です。
+
+[start=5]
+. 「次」をクリックします。「リモート接続」パネルが開きます。チュートリアルのlink:remote-hosting-and-ftp-account.html[+リモートWebサーバーへのPHPアプリケーションのデプロイ+]に、リモート接続の設定方法が説明されています。
== 新規プロジェクトのデフォルト実行構成の指定
@@ -138,13 +156,21 @@ image::images/new-php-project-with-ssources.png[]
1. 「実行方法」ドロップダウン・リストから「ローカルWebサイト」を選択します。
2. 「プロジェクトURL」フィールドで、自動的に生成されたURLアドレスを確認します。Apache HTTPサーバーがデフォルトのポート80で待機していることを確認します。そうでない場合、ポート番号を ``localhost:<port number>`` の形式で明示的に指定します。
+
image::images/run-configuration-local-server-project-with-existing-sources.png[]
-3. 既存のソースからプロジェクトを作成する場合、インデックス・ファイルとして使用するソース・ファイルを選択できます。
-4. プロジェクトのソース・ファイルをNetBeans IDEプロジェクトとは異なるディレクトリに格納するには、「ファイルをソース・フォルダから別の場所にコピー」を選択します。_プロジェクトを既存のソースから作成する場合は、既存のソースがApacheサーバーのWebフォルダにすでに存在しないかぎり、これは必要なステップです。_
+
+
+[start=3]
+. 既存のソースからプロジェクトを作成する場合、インデックス・ファイルとして使用するソース・ファイルを選択できます。
+
+[start=4]
+. プロジェクトのソース・ファイルをNetBeans IDEプロジェクトとは異なるディレクトリに格納するには、「ファイルをソース・フォルダから別の場所にコピー」を選択します。_プロジェクトを既存のソースから作成する場合は、既存のソースがApacheサーバーのWebフォルダにすでに存在しないかぎり、これは必要なステップです。_
フィールドにはデフォルトで、 ``<ドキュメント・ルート>\<新規PHPプロジェクト>`` というパスが指定されています。必要な場合は、「参照」ボタンを使用して別のパスを指定します。
ドキュメント・ルートは、Webサーバーがブラウザで開くファイルを探すフォルダです。ドキュメント・ルートは、Webサーバーのlink:../../trails/php.html#configuration[+構成ファイル+]で指定されています。
ウィザードは、Apacheのインストール・タイプ(コンポーネントまたはパッケージ内のいずれか)を検出し、現在のインストール・タイプ用に ``htdocs`` フォルダのデフォルトの場所へのパスを提供します。そのため、ApacheサーバーまたはAMPパッケージのインストール中にデフォルトの設定を受け入れた場合は、ドロップダウン・リストからパスを選択します。
-5. 「終了」をクリックします。IDEによってPHPプロジェクトが作成されます。
+
+[start=5]
+. 「終了」をクリックします。IDEによってPHPプロジェクトが作成されます。
=== リモートWebサイト
@@ -155,17 +181,31 @@ image::images/run-configuration-local-server-project-with-existing-sources.png[]
=== スクリプト
1. 「実行方法」ドロップダウン・リストから「スクリプト」を選択します。
+
image::images/project-properties-script.png[]
-2. PHPエンジンの場所を指定するには、「デフォルトのPHPインタプリタを使用」ボックスの横にある「構成」ボタンをクリックします。PHPオプションのダイアログの「一般」タブが開きます。
+
+
+[start=2]
+. PHPエンジンの場所を指定するには、「デフォルトのPHPインタプリタを使用」ボックスの横にある「構成」ボタンをクリックします。PHPオプションのダイアログの「一般」タブが開きます。
+
image::images/run-config-script-options-m1.png[]
-3. 「PHP 5インタプリタ」フィールドで、 ``php.exe`` ファイルへのパスを指定します。必要な場合は、「参照」または「検索」ボタンを使用します。
-4. スクリプトの実行結果の表示方法を指定するには、「結果を開く場所」領域で適切なチェックボックスを選択します。次のオプションがあります。
+
+
+[start=3]
+. 「PHP 5インタプリタ」フィールドで、 ``php.exe`` ファイルへのパスを指定します。必要な場合は、「参照」または「検索」ボタンを使用します。
+
+[start=4]
+. スクリプトの実行結果の表示方法を指定するには、「結果を開く場所」領域で適切なチェックボックスを選択します。次のオプションがあります。
* 出力ウィンドウ。スクリプトの実行結果は、NetBeans IDEウィンドウの下部にある出力ウィンドウに表示されます。
* Webブラウザ。スクリプト実行の結果は、HTMLファイルの形式でデフォルトのブラウザ・ウィンドウに表示されます。
* エディタ。スクリプト実行の結果は、HTMLファイルとしてIDEエディタ・ウィンドウに表示されます。
-5. 「OK」をクリックします。「オプション」ダイアログ・ボックスが閉じ、システムは「実行構成」パネルに戻ります。
-6. ``debug=true`` などの任意の引数と、link:http://www.php.net/manual/en/features.commandline.options.php[+PHPコマンド行オプション+]を追加します。
+
+[start=5]
+. 「OK」をクリックします。「オプション」ダイアログ・ボックスが閉じ、システムは「実行構成」パネルに戻ります。
+
+[start=6]
+. ``debug=true`` などの任意の引数と、link:http://www.php.net/manual/en/features.commandline.options.php[+PHPコマンド行オプション+]を追加します。
== プロジェクト設定のカスタマイズ
@@ -181,8 +221,12 @@ image::images/run-config-script-options-m1.png[]
1. 「Webルート」フィールドには使用しているアプリケーション・サイトのルート・フォルダが表示されます。デフォルトでは、このフィールドにはソース・フォルダが表示されます。Webルートを変更するには、「参照」をクリックし、別のフォルダを選択します。
2. 必要に応じて、「<<location,ファイルをソース・フォルダから別の場所にコピー>>」を選択し、記憶域フォルダへのパスを指定します。
3. 必要に応じてエンコーディングを変更します。
+
image::images/pprop-sources.png[]
-4. プロジェクトのカスタマイズを完了するには、「OK」をクリックします。
+
+
+[start=4]
+. プロジェクトのカスタマイズを完了するには、「OK」をクリックします。
=== 実行構成
@@ -195,8 +239,12 @@ image::images/pprop-sources.png[]
3. 「構成名」フィールドで、新規の実行構成の名前を入力し、「OK」をクリックします。「実行構成」パネルに戻ります。
4. プロジェクトの作成中に、<<runConfiguration,デフォルトの実行構成>>を定義したのと同じ方法で実行構成の設定を定義し、「OK」をクリックします。新規の構成が「構成」ドロップダウン・リストに追加されます。
5. 構成を除去するには、「構成」ドロップダウン・リストから構成を選択し、「削除」をクリックします。
+
image::images/pprop-runconfig.png[]
-6. プロジェクトのカスタマイズを完了するには、「OK」をクリックします。
+
+
+[start=6]
+. プロジェクトのカスタマイズを完了するには、「OK」をクリックします。
=== PHPインクルード・パス
@@ -208,8 +256,12 @@ image::images/pprop-runconfig.png[]
2. 該当するフォルダを選択し、「開く」をクリックします。「PHPインクルード・パス」パネルに戻ります。新しいフォルダがリストに追加されます。
3. リスト内を移動するには、「上へ移動」ボタンまたは「下へ移動」ボタンを使用します。
4. インクードされたフォルダのリストからフォルダを除去するには、フォルダを選択し、「除去」をクリックします。
+
image::images/pprop-include-path.png[]
-5. プロジェクトのカスタマイズを完了するには、「OK」をクリックします。
+
+
+[start=5]
+. プロジェクトのカスタマイズを完了するには、「OK」をクリックします。
=== フォーマット
@@ -220,15 +272,25 @@ image::images/pprop-include-path.png[]
1. 「グローバル・オプションを使用」を選択します。
2. 「グローバル・オプションを編集」をクリックします。IDEの「オプション」ダイアログで、「エディタ」>「フォーマット」タブが開きます。
+
image::images/global-formatting.png[]
-3. 言語ドロップダウン・リストから、設定を適用する言語を選択します。
-4. 「カテゴリ」ドロップダウン・リストから、設定を適用するフォーマット項目を選択します。
-5. 目的のフォーマットを設定して「OK」をクリックします。
-6. 詳細情報については「ヘルプ」ボタンをクリックします。
+
+
+[start=3]
+. 言語ドロップダウン・リストから、設定を適用する言語を選択します。
+
+[start=4]
+. 「カテゴリ」ドロップダウン・リストから、設定を適用するフォーマット項目を選択します。
+
+[start=5]
+. 目的のフォーマットを設定して「OK」をクリックします。
+
+[start=6]
+. 詳細情報については「ヘルプ」ボタンをクリックします。
*プロジェクト固有のフォーマットを定義するには、次を実行します。*
-1. 「プロジェクト固有オプションを使用」を選択します。非表示領域が表示されます。image::images/pprop-formatting.png[]
+1. 「プロジェクト固有オプションを使用」を選択します。非表示領域が表示されます。image:images/pprop-formatting.png[]
2. 「言語」ドロップダウン・リストから、「すべての言語」または「PHP」を選択します。この場合の「すべての言語」とは、PHPと、PHPプロジェクト内にある他のすべての言語を意味します。
3. 「カテゴリ」ドロップダウン・リストから、設定を適用するフォーマット項目を選択します。
4. 目的のフォーマットを設定して「OK」をクリックします。
diff --git a/netbeans.apache.org/src/content/kb/docs/php/project-setup_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/project-setup_pt_BR.asciidoc
index a7f56c2..b637356 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/project-setup_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/project-setup_pt_BR.asciidoc
@@ -32,9 +32,6 @@
Este tutorial mostra como configurar um projeto PHP no NetBeans IDE.
-image::images/netbeans-stamp-80-74-73.png[title="O conteúdo desta página se aplica ao NetBeans IDE 7.2, 7.3, 7.4 e 8.0"]
-
-
*Para seguir este tutorial, são necessários os recursos e o software a seguir.*
|===
@@ -82,10 +79,18 @@ A raiz do documento é a pasta em que o servidor Web local procura pelos arquivo
Uma cópia dos arquivos de código-fonte deve ser mantida em uma subpasta da raiz do documento. Entretanto, você pode ter uma Pasta de Códigos-Fonte em um local diferente da raiz do documento e copiar os arquivos de código-fonte desse local para a raiz do documento. Consulte <<copy-sources,Especificando a Configuração de Execução>>.
-4. Na lista drop-down Codificação Default, selecione a codificação default do seu projeto.
-5. Se você desejar armazenar metadados do NetBeans em um local diferente dos seus arquivos de código-fonte, selecione "Colocar metadados do NetBeans em um diretório separado". Por exemplo, você pode querer armazenar seus códigos-fonte na raiz do documento, mas os metadados do NetBeans no diretório Projetos do NetBeans.
+
+[start=4]
+. Na lista drop-down Codificação Default, selecione a codificação default do seu projeto.
+
+[start=5]
+. Se você desejar armazenar metadados do NetBeans em um local diferente dos seus arquivos de código-fonte, selecione "Colocar metadados do NetBeans em um diretório separado". Por exemplo, você pode querer armazenar seus códigos-fonte na raiz do documento, mas os metadados do NetBeans no diretório Projetos do NetBeans.
+
image::images/new-php-project-m1.png[]
-6. Clique em Próximo. O painel Configuração de Execução será aberto.
+
+
+[start=6]
+. Clique em Próximo. O painel Configuração de Execução será aberto.
=== Importando Arquivos Locais de Código-Fonte Existentes para um Projeto
@@ -93,11 +98,21 @@ image::images/new-php-project-m1.png[]
1. Na área Projetos, selecione Aplicação PHP com Códigos-Fonte Existentes e clique em Próximo. O painel Novo Projeto PHP > Nome e Localização será aberto.
2. No campo de texto Nome do Projeto, digite o nome do projeto.
3. No campo Pasta de Códigos-Fonte, especifique a pasta da qual você deseja importar os arquivos de código-fonte.
-*Observação:*<<localServer, se você for executar o projeto em um servidor Web local, não se esqueça de especificar a >><<copyFilesFromSourcesFolder,cópia dos arquivos de código-fonte>> para ele.
-4. Na lista drop-down Codificação Default, selecione a codificação default do seu projeto.
-5. Se você desejar armazenar metadados do NetBeans em um local diferente dos seus arquivos de código-fonte, selecione "Colocar metadados do NetBeans em um diretório separado". Por exemplo, você pode querer armazenar seus códigos-fonte na raiz do documento, mas os metadados do NetBeans no diretório Projetos do NetBeans.
+
+NOTE: <<localServer, se você for executar o projeto em um servidor Web local, não se esqueça de especificar a >><<copyFilesFromSourcesFolder,cópia dos arquivos de código-fonte>> para ele.
+
+
+[start=4]
+. Na lista drop-down Codificação Default, selecione a codificação default do seu projeto.
+
+[start=5]
+. Se você desejar armazenar metadados do NetBeans em um local diferente dos seus arquivos de código-fonte, selecione "Colocar metadados do NetBeans em um diretório separado". Por exemplo, você pode querer armazenar seus códigos-fonte na raiz do documento, mas os metadados do NetBeans no diretório Projetos do NetBeans.
+
image::images/new-php-project-with-ssources.png[]
-6. Clique em Próximo. O painel Configuração de Execução será aberto.
+
+
+[start=6]
+. Clique em Próximo. O painel Configuração de Execução será aberto.
=== Importando Arquivos Remotos de Código-Fonte Existentes para um Projeto
@@ -108,8 +123,12 @@ image::images/new-php-project-with-ssources.png[]
A raiz do documento é a pasta em que o servidor Web local procura pelos arquivos a serem abertos no browser. A raiz do documento é especificada no link:../../trails/php.html#configuration[+arquivo de configuração+] do servidor Web. Depois da instalação, o assistente Novo Projeto localiza a raiz do documento e por default especifica o seguinte caminho: ``<Raiz do Documento>\<Novo Projeto PHP>`` . Observe que é útil poder testar o projeto em um servidor local.
-4. Se você desejar armazenar metadados do NetBeans em um local diferente dos seus arquivos de código-fonte, selecione "Colocar metadados do NetBeans em um diretório separado". Por exemplo, você pode querer armazenar seus códigos-fonte na raiz do documento, mas os metadados do NetBeans no diretório Projetos do NetBeans.
-5. Clique em Próximo. O painel Conexão Remota será aberto. O tutorial link:remote-hosting-and-ftp-account.html[+Implantando uma Aplicação PHP em um Servidor Web Remoto+] descreve como configurar conexões remotas.
+
+[start=4]
+. Se você desejar armazenar metadados do NetBeans em um local diferente dos seus arquivos de código-fonte, selecione "Colocar metadados do NetBeans em um diretório separado". Por exemplo, você pode querer armazenar seus códigos-fonte na raiz do documento, mas os metadados do NetBeans no diretório Projetos do NetBeans.
+
+[start=5]
+. Clique em Próximo. O painel Conexão Remota será aberto. O tutorial link:remote-hosting-and-ftp-account.html[+Implantando uma Aplicação PHP em um Servidor Web Remoto+] descreve como configurar conexões remotas.
== Especificando a Configuração de Execução Default do Novo Projeto
@@ -138,13 +157,21 @@ Uma configuração de web site que envolve uma cópia das suas pastas de código
1. Na lista drop-down Executar Como, selecione Web Site Local.
2. No campo URL do Projeto, verifique o endereço do URL gerado automaticamente. Verifique se o servidor HTTP do Apache ouve a porta default 80. Caso contrário, especifique explicitamente o número da porta no formato ``localhost:<número da porta>`` .
+
image::images/run-configuration-local-server-project-with-existing-sources.png[]
-3. Se você estiver criando um projeto a partir de códigos-fonte existentes, poderá selecionar qual arquivo de código-fonte usar como o arquivo de índice.
-4. Para armazenar os arquivos de código-fonte do projeto em um diretório diferente do diretório do projeto NetBeans IDE, selecione “Copiar arquivos da Pasta de Códigos-Fonte para outro local”. _Se você estiver criando um projeto a partir de códigos-fonte existentes, essa é uma etapa necessária, a não ser que os códigos-fonte existentes já estejam na pasta Web do servidor Apache._
+
+
+[start=3]
+. Se você estiver criando um projeto a partir de códigos-fonte existentes, poderá selecionar qual arquivo de código-fonte usar como o arquivo de índice.
+
+[start=4]
+. Para armazenar os arquivos de código-fonte do projeto em um diretório diferente do diretório do projeto NetBeans IDE, selecione “Copiar arquivos da Pasta de Códigos-Fonte para outro local”. _Se você estiver criando um projeto a partir de códigos-fonte existentes, essa é uma etapa necessária, a não ser que os códigos-fonte existentes já estejam na pasta Web do servidor Apache._
O campo, por default, especifica o seguinte caminho: ``<Raiz do Documento>\<Novo Projeto PHP>`` . Se necessário, use o botão Procurar para especificar um caminho diferente.
A raiz do documento é a pasta em que o servidor Web procura por arquivos a serem abertos no browser. A raiz do documento é especificada no link:../../trails/php.html#configuration[+arquivo de configuração+] do servidor Web.
O assistente detecta o tipo de instalação do Apache, um componente ou dentro de um pacote, e fornece o caminho para a localização default da pasta ``htdocs`` do tipo de instalação atual. Portanto, se você tiver aceitado as definições default durante a instalação do servidor Apache ou do pacote AMP, selecione o caminho na lista drop-down.
-5. Clique em Finalizar. O IDE criará o projeto PHP.
+
+[start=5]
+. Clique em Finalizar. O IDE criará o projeto PHP.
=== Web Site Remoto
@@ -155,17 +182,31 @@ Cosulte o tutorial link:remote-hosting-and-ftp-account.html[+Implantando uma Apl
=== Script
1. Na lista drop-down Executar Como, selecione Script.
+
image::images/project-properties-script.png[]
-2. Para especificar a localização do mecanismo PHP, clique no botão Configurar ao lado da caixa Usar Interpretador PHP Default. A caixa de diálogo Opções do PHP será aberta na guia Geral.
+
+
+[start=2]
+. Para especificar a localização do mecanismo PHP, clique no botão Configurar ao lado da caixa Usar Interpretador PHP Default. A caixa de diálogo Opções do PHP será aberta na guia Geral.
+
image::images/run-config-script-options-m1.png[]
-3. No campo Interpretador do PHP 5, especifique o caminho para o arquivo ``php.exe`` . Use o botão Procurar ou Pesquisar..., se necessário.
-4. Para especificar como os resultados da execução do script serão mostrados, marque a caixa de seleção relevante na área Abrir Resultado Em. As seguintes opções estão disponíveis:
+
+
+[start=3]
+. No campo Interpretador do PHP 5, especifique o caminho para o arquivo ``php.exe`` . Use o botão Procurar ou Pesquisar..., se necessário.
+
+[start=4]
+. Para especificar como os resultados da execução do script serão mostrados, marque a caixa de seleção relevante na área Abrir Resultado Em. As seguintes opções estão disponíveis:
* Janela de Saída. Os resultados da execução de um script aparecerão na janela de saída na parte inferior da janela do NetBeans IDE.
* Web Browser. A janela do browser default se abrirá com os resultados da execução de um script no formato de um arquivo HTML.
* Editor. Os resultados da execução de um script se abrirão como um arquivo HTML na janela do editor do IDE.
-5. Clique em OK. A caixa de diálogo Opções se fechará e o sistema retornará para o painel Configuração de Execução.
-6. Adicionar qualquer argumento, como ``debug=true`` e qualquer link:http://www.php.net/manual/en/features.commandline.options.php[+opção de linha de comandos PHP+].
+
+[start=5]
+. Clique em OK. A caixa de diálogo Opções se fechará e o sistema retornará para o painel Configuração de Execução.
+
+[start=6]
+. Adicionar qualquer argumento, como ``debug=true`` e qualquer link:http://www.php.net/manual/en/features.commandline.options.php[+opção de linha de comandos PHP+].
== Personalizando a Configuração do Projeto
@@ -181,8 +222,12 @@ No painel Códigos-fonte:
1. O campo Raiz da Web mostra a pasta raiz do site da sua aplicação. Por default, o campo mostra a pasta Códigos-fonte. Para alterar a raiz da Web, clique em Procurar e selecione outra pasta.
2. Selecione <<location,Copiar arquivos da pasta de Códigos-Fonte>> para outra localização, se necessário, e especifique o caminho para a pasta de armazenamento.
3. Altere a codificação, se necessário
+
image::images/pprop-sources.png[]
-4. Para concluir a personalização do projeto, clique em OK.
+
+
+[start=4]
+. Para concluir a personalização do projeto, clique em OK.
=== Configuração de Execução
@@ -195,8 +240,12 @@ No painel Configuração de Execução, modifique a configuração de execução
3. No campo Nome da Configuração, digite o nome da nova configuração de execução e clique em OK. Você retornará para o painel Configuração de Execução.
4. Especifique as definições da configuração de execução da mesma forma que a <<runConfiguration,configuração de execução default>> foi definida durante a criação do projeto e clique em OK. A nova configuração será adicionada à lista drop-down Configuração.
5. Para remover uma configuração, selecione-a na lista drop-down Configuração e clique em Deletar.
+
image::images/pprop-runconfig.png[]
-6. Para concluir a personalização do projeto, clique em OK.
+
+
+[start=6]
+. Para concluir a personalização do projeto, clique em OK.
=== Incluir Caminho do PHP
@@ -208,8 +257,12 @@ No painel Incluir Caminho, especifique a localização dos arquivos que você pr
2. Selecione as pastas relevantes e clique em Abrir. Você retornará para o painel Incluir Caminho do PHP. A nova pasta será adicionada à lista.
3. Para navegar pela lista, use os botões Mover para Cima e Mover para Baixo.
4. Para remover uma pasta da lista de pastas incluída, selecione a pasta e clique em Remover.
+
image::images/pprop-include-path.png[]
-5. Para concluir a personalização do projeto, clique em OK.
+
+
+[start=5]
+. Para concluir a personalização do projeto, clique em OK.
=== Formatando
@@ -220,15 +273,25 @@ No painel Formatação, defina o estilo de formatação que deseja aplicar aos a
1. Selecione "Usar opções globais".
2. Clique em Editar Opções Globais. A caixa de diálogo de opções do IDE abre na guia Editor > Formatação.
+
image::images/global-formatting.png[]
-3. Da lista drop-down Linguagem, selecione a linguagem na qual as definições deverão ser aplicadas.
-4. Na lista drop-down Categorias, selecione os itens de formato nos quais a definição será aplicada.
-5. Defina sua formatação desejada e clique em OK.
-6. Clique no botão Ajuda para obter informações detalhadas.
+
+
+[start=3]
+. Da lista drop-down Linguagem, selecione a linguagem na qual as definições deverão ser aplicadas.
+
+[start=4]
+. Na lista drop-down Categorias, selecione os itens de formato nos quais a definição será aplicada.
+
+[start=5]
+. Defina sua formatação desejada e clique em OK.
+
+[start=6]
+. Clique no botão Ajuda para obter informações detalhadas.
*Para definir a formatação específica do projeto:*
-1. Selecione “Usar opções específicas do projeto". A área oculta será exibida. image::images/pprop-formatting.png[]
+1. Selecione “Usar opções específicas do projeto". A área oculta será exibida. image:images/pprop-formatting.png[]
2. Na lista drop-down Linguagem, selecione Todas as Linguagens ou PHP. Nesse caso, Todas as Linguagens é o PHP e todas as outras linguagens você tem no seu projeto PHP.
3. Na lista drop-down Categorias, selecione os itens de formato nos quais a definição será aplicada.
4. Defina sua formatação desejada e clique em OK.
diff --git a/netbeans.apache.org/src/content/kb/docs/php/project-setup_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/php/project-setup_ru.asciidoc
index 6d76fb6..7df0f56 100644
--- a/netbeans.apache.org/src/content/kb/docs/php/project-setup_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/php/project-setup_ru.asciidoc
@@ -31,10 +31,6 @@
В этом учебном руководстве описывается настройка проекта PHP в IDE NetBeans.
-
-image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой страницы применимо к IDE NetBeans 7.2, 7.3, 7.4 и 8.0"]
-
-
*Для работы с этим учебным курсом требуется следующее программное обеспечение и ресурсы.*
|===
@@ -82,10 +78,18 @@ image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой
Копия исходных файлов должна быть сохранена в подпапке корневого узла документов. Однако папка "Sources Folder" не обязательно должна находиться в корневом узле документов, ей можно назначить и другое местоположение и отсюда копировать исходные файлы в корневой узел. См. раздел <<copy-sources,Выбор настройки выполнения нового проекта>>.
-4. В раскрывающемся списке "Default Encoding" ("Кодировка по умолчанию") выберите для проекта кодировку по умолчанию.
-5. Если требуется сохранение метаданных NetBeans в другом местоположении (не в папке "Source files"), выберите команду "Put NetBeans metadata into a separate directory" ("Поместить метаданные NetBeans в отдельный каталог"). Например, может потребоваться сохранение исходных файлов в корневом узле документов, а метаданных NetBeans – в каталоге "NetBeansProjects".
+
+[start=4]
+. В раскрывающемся списке "Default Encoding" ("Кодировка по умолчанию") выберите для проекта кодировку по умолчанию.
+
+[start=5]
+. Если требуется сохранение метаданных NetBeans в другом местоположении (не в папке "Source files"), выберите команду "Put NetBeans metadata into a separate directory" ("Поместить метаданные NetBeans в отдельный каталог"). Например, может потребоваться сохранение исходных файлов в корневом узле документов, а метаданных NetBeans – в каталоге "NetBeansProjects".
+
image::images/new-php-project-m1.png[]
-6. Нажмите кнопку "Далее". Откроется панель "Настройки выполнения".
+
+
+[start=6]
+. Нажмите кнопку "Далее". Откроется панель "Настройки выполнения".
=== Импорт существующих локальных исходных файлов в проект
@@ -93,11 +97,21 @@ image::images/new-php-project-m1.png[]
1. В области "Projects" выберите "PHP Application with Existing Sources" ("Приложение PHP с существующими исходными кодами") и нажмите "Next". Откроется панель "Новый проект PHP > Имя и местоположение".
2. В текстовом поле "Project Name" ("Имя проекта") введите имя проекта.
3. В поле "Sources Folder" укажите папку, из которой требуется импортировать исходные файлы.
-*Примечание.* Если планируется запуск <<localServer,проекта на локальном веб-сервере>>, не забудьте указать <<copyFilesFromSourcesFolder,копирование исходного файла>> в него.
-4. В раскрывающемся списке "Default Encoding" ("Кодировка по умолчанию") выберите для проекта кодировку по умолчанию.
-5. Если требуется сохранение метаданных NetBeans в другом местоположении (не в папке "Source files"), выберите команду "Put NetBeans metadata into a separate directory" ("Поместить метаданные NetBeans в отдельный каталог"). Например, может потребоваться сохранение исходных файлов в корневом узле документов, а метаданных NetBeans – в каталоге "NetBeansProjects".
+
+NOTE: Если планируется запуск <<localServer,проекта на локальном веб-сервере>>, не забудьте указать <<copyFilesFromSourcesFolder,копирование исходного файла>> в него.
+
+
+[start=4]
+. В раскрывающемся списке "Default Encoding" ("Кодировка по умолчанию") выберите для проекта кодировку по умолчанию.
+
+[start=5]
+. Если требуется сохранение метаданных NetBeans в другом местоположении (не в папке "Source files"), выберите команду "Put NetBeans metadata into a separate directory" ("Поместить метаданные NetBeans в отдельный каталог"). Например, может потребоваться сохранение исходных файлов в корневом узле документов, а метаданных NetBeans – в каталоге "NetBeansProjects".
+
image::images/new-php-project-with-ssources.png[]
-6. Нажмите кнопку "Далее". Откроется панель "Настройки выполнения".
+
+
+[start=6]
+. Нажмите кнопку "Далее". Откроется панель "Настройки выполнения".
=== Импорт существующих удаленных исходных файлов в проект
@@ -108,8 +122,12 @@ image::images/new-php-project-with-ssources.png[]
Корневой узел документов представляет собой папку, в которой на локальном веб-сервере выполняется поиск файлов для просмотра в браузере. Корневой узел документов указан в link:../../trails/php.html#configuration[+файле настройки+] веб-сервера. После завершения установки мастер создания проекта определяет корневой узел документов и по умолчанию указывает следующий путь: ``<Document Root>\<New PHP Project>`` . Обратите внимание, что полезно иметь возможность протестировать проект на локал [...]
-4. Если требуется сохранение метаданных NetBeans в другом местоположении (не в папке "Source files"), выберите команду "Put NetBeans metadata into a separate directory" ("Поместить метаданные NetBeans в отдельный каталог"). Например, может потребоваться сохранение исходных файлов в корневом узле документов, а метаданных NetBeans – в каталоге "NetBeansProjects".
-5. Нажмите кнопку "Далее". Откроется панель "Remote Connection" ("Удаленное подключение"). Процесс настройки удаленных подключений описан в учебном курсе link:remote-hosting-and-ftp-account.html[+Развертывание приложения PHP на удаленном веб-сервере+].
+
+[start=4]
+. Если требуется сохранение метаданных NetBeans в другом местоположении (не в папке "Source files"), выберите команду "Put NetBeans metadata into a separate directory" ("Поместить метаданные NetBeans в отдельный каталог"). Например, может потребоваться сохранение исходных файлов в корневом узле документов, а метаданных NetBeans – в каталоге "NetBeansProjects".
+
+[start=5]
+. Нажмите кнопку "Далее". Откроется панель "Remote Connection" ("Удаленное подключение"). Процесс настройки удаленных подключений описан в учебном курсе link:remote-hosting-and-ftp-account.html[+Развертывание приложения PHP на удаленном веб-сервере+].
== Выбор настройки выполнения нового проекта по умолчанию
@@ -138,13 +156,21 @@ image::images/new-php-project-with-ssources.png[]
1. В раскрывающемся списке "Run As" ("Выполнить как") выберите "Local Web Site" ("Локальный веб-сайт").
2. В поле "Project URL" ("URL-адрес проекта") проверьте автоматически предложенный URL-адрес. Убедитесь, что сервер HTTP Apache прослушивает порт 80 по умолчанию. Если это не так, явным образом укажите номер порта в формате ``localhost:<номер порта>`` .
+
image::images/run-configuration-local-server-project-with-existing-sources.png[]
-3. При создании проекта из существующих исходных кодов можно выбрать файл исходного кода для использования в качестве файла индекса.
-4. Для хранения исходных файлов проекта в другом каталоге, отличном от проекта IDE NetBeans выберите "Копировать файлы из папки исходных файлов в другое местоположение". _При создании проекта из существующих исходных кодов данное действие является обязательным, кроме случаев, когда существующие исходные коды уже находились в папке "web" сервера Apache._
+
+
+[start=3]
+. При создании проекта из существующих исходных кодов можно выбрать файл исходного кода для использования в качестве файла индекса.
+
+[start=4]
+. Для хранения исходных файлов проекта в другом каталоге, отличном от проекта IDE NetBeans выберите "Копировать файлы из папки исходных файлов в другое местоположение". _При создании проекта из существующих исходных кодов данное действие является обязательным, кроме случаев, когда существующие исходные коды уже находились в папке "web" сервера Apache._
В этом поле по умолчанию указан следующий путь: `` <Document Root>\<New PHP Project>`` . Используйте кнопку "Browse" ("Обзор") для указания другого пути при необходимости.
Корень документов – это папка, в которой веб-сервер ищет файлы для открытия в браузере. Корневой узел документов указан в link:../../trails/php.html#configuration[+файле настройки+] веб-сервера.
Мастер обнаруживает тип установки Apache либо как отдельного компонента, либо в составе пакета и предлагает путь к папке по умолчанию ``htdocs`` (папка для текущего типа установки). Поэтому при принятии параметров по умолчанию в течение настройки сервера Apache или пакета AMP следует выбрать соответствующий путь в раскрывающемся списке.
-5. Нажмите кнопку 'Готово'. Среда IDE создает проект PHP.
+
+[start=5]
+. Нажмите кнопку 'Готово'. Среда IDE создает проект PHP.
=== Удаленный веб-сайт
@@ -155,17 +181,31 @@ image::images/run-configuration-local-server-project-with-existing-sources.png[]
=== Сценарий
1. В раскрывающемся списке "Run As" выберите "Script".
+
image::images/project-properties-script.png[]
-2. Чтобы указать местоположение механизма PHP, нажмите кнопку "Configure" рядом с окном "Use Default PHP Interpreter". На вкладке "General" откроется диалоговое окно "PHP Options".
+
+
+[start=2]
+. Чтобы указать местоположение механизма PHP, нажмите кнопку "Configure" рядом с окном "Use Default PHP Interpreter". На вкладке "General" откроется диалоговое окно "PHP Options".
+
image::images/run-config-script-options-m1.png[]
-3. В поле "PHP 5 Interpreter" укажите путь к файлу ``php.exe`` . При необходимости используйте кнопку "Browse" или кнопку "Search...".
-4. Для указания формы отображения результатов выполнения сценария установите соответствующий флажок в области "Open Result In". Доступны следующие параметры:
+
+
+[start=3]
+. В поле "PHP 5 Interpreter" укажите путь к файлу ``php.exe`` . При необходимости используйте кнопку "Browse" или кнопку "Search...".
+
+[start=4]
+. Для указания формы отображения результатов выполнения сценария установите соответствующий флажок в области "Open Result In". Доступны следующие параметры:
* Окно 'Результаты'. Результаты выполнения сценария будут отображены в окне выходных данных в нижней части окна IDE NetBeans.
* Веб-браузер. Откроется окно браузера по умолчанию с результатами выполнения сценария в форме файла HTML.
* Редактор. Результаты выполнения сценария отобразятся в виде файла HTML в окне редактора IDE.
-5. Нажмите кнопку "ОК". Диалоговое окно "Options" закроется, и будет выполнен возврат к панели "Run Configuration".
-6. Добавьте любые аргументы, например ``debug=true`` и любые link:http://www.php.net/manual/en/features.commandline.options.php[+необязательные параметры командной строки PHP+].
+
+[start=5]
+. Нажмите кнопку "ОК". Диалоговое окно "Options" закроется, и будет выполнен возврат к панели "Run Configuration".
+
+[start=6]
+. Добавьте любые аргументы, например ``debug=true`` и любые link:http://www.php.net/manual/en/features.commandline.options.php[+необязательные параметры командной строки PHP+].
== Настройка проекта
@@ -181,8 +221,12 @@ image::images/run-config-script-options-m1.png[]
1. В поле "Web Root" отображается корневая папка местоположения приложения. По умолчанию в этом поле отображается папка "Sources". Для изменения корневого веб-узла нажмите кнопку "Browse" и выберите другую папку.
2. При необходимости выберите "<<location,Copy files from Sources Folder to another location>>" и укажите путь к папке, в которой сохранены данные.
3. При необходимости измените кодировку.
+
image::images/pprop-sources.png[]
-4. Для завершения настройки проекта нажмите кнопку "ОК".
+
+
+[start=4]
+. Для завершения настройки проекта нажмите кнопку "ОК".
=== Настройка выполнения проекта
@@ -195,8 +239,12 @@ image::images/pprop-sources.png[]
3. В поле "Configuration Name" введите имя новой настройки выполнения и нажмите кнопку "ОК". Будет выполнен возврат к панели "Настройки выполнения".
4. Определите такие же параметры настройки, которые были установлены во время создания проекта была при определении <<runConfiguration,настройки выполнения по умолчанию>>, и нажмите кнопку "ОК". Новая настройка добавлена в раскрывающийся список "Configuration".
5. Для удаления настройки выберите ее в раскрывающемся списке "Configuration" и нажмите кнопку "Delete" (Удалить).
+
image::images/pprop-runconfig.png[]
-6. Для завершения настройки проекта нажмите кнопку "ОК".
+
+
+[start=6]
+. Для завершения настройки проекта нажмите кнопку "ОК".
=== Панель "PHP Include Path"
@@ -208,8 +256,12 @@ image::images/pprop-runconfig.png[]
2. Выберите требуемые папки и нажмите "Open". Будет выполнен возврат к панели "PHP Include Path". Новая папка добавлена в список.
3. Для перемещения по списку используйте кнопки "Move Up" и "Down".
4. Для удаления папки из списка включенных папок выберите папку и нажмите "Remove".
+
image::images/pprop-include-path.png[]
-5. Для завершения настройки проекта нажмите кнопку "ОК".
+
+
+[start=5]
+. Для завершения настройки проекта нажмите кнопку "ОК".
=== Форматирование
@@ -220,15 +272,25 @@ image::images/pprop-include-path.png[]
1. Выберите "Use global options".
2. Щeлкните "Edit Global Options". На вкладке "Editor > Formatting" откроется диалоговое окно "IDE Options".
+
image::images/global-formatting.png[]
-3. В раскрывающемся списке "Language" выберите язык, к которому должны быть применены параметры установки.
-4. В раскрывающемся списке "Categories" выберите элементы формата, к которым будут применены эти параметры.
-5. Укажите нужный тип форматирования и нажмите кнопку "ОК".
-6. Для получения дополнительных сведений нажмите кнопку "Help".
+
+
+[start=3]
+. В раскрывающемся списке "Language" выберите язык, к которому должны быть применены параметры установки.
+
+[start=4]
+. В раскрывающемся списке "Categories" выберите элементы формата, к которым будут применены эти параметры.
+
+[start=5]
... 5647 lines suppressed ...
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@netbeans.apache.org
For additional commands, e-mail: commits-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists