<?xml version="1.0" encoding="utf-8"?>

<!-- EN-Revision: 9e6c3416c5c285f807a734e4663c399612777d7e Maintainer: shein Status: ready -->

<!-- Reviewed: no -->

<chapter xml:id="faq.html" xmlns="http://docbook.org/ns/docbook">

<title>PHP и HTML-разметка</title>

<titleabbrev>PHP и HTML</titleabbrev>

<para>

Язык программирования PHP и язык гипертекстовой разметки HTML тесно взаимодействуют:

PHP умеет генерировать HTML, а HTML умеет передавать информацию PHP. Перед чтением вопросов в этом разделе

важно понимать, как получать <link linkend="language.variables.external">

переменные из внешних источников</link>. Страницы руководства по этой теме

содержат много примеров.

</para>

<qandaset>

<qandaentry xml:id="faq.html.encoding">

<question>

<para>

Какое кодирование или декодирование я должен выполнять при передаче значения

через форму или URL-адрес?

</para>

</question>

<answer>

<para>

Есть несколько этапов, на которых кодировка важна. Предположим, что у вас

есть переменная <varname>$data</varname> с типом <type>string</type>, которая содержит

строку, которую вы хотите передать без кодирования. Вот эти этапы:

<itemizedlist>

<listitem>

<para>

Интерпретация HTML. Чтобы задать произвольную строку,

вы <emphasis>должны</emphasis> заключить её в двойные кавычки и

использовать функцию <function>htmlspecialchars</function> для кодирования.

</para>

</listitem>

<listitem>

<para>

URL: URL-адрес состоит из нескольких частей. Если вы хотите, чтобы

данные были восприняты как один элемент, <emphasis>нужно</emphasis>

закодировать их функцией <function>urlencode</function>.

</para>

</listitem>

</itemizedlist>

</para>

<para>

<example>

<title>Скрытый элемент HTML-формы</title>

<programlisting role="php">

<![CDATA[

<?php

echo '<input type="hidden" value="' . htmlspecialchars($data) . '" />'."\n";

?>

]]>

</programlisting>

</example>

<note>

<simpara>

Кодировать перменную <varname>$data</varname> функцией

<function>urlencode</function> неправильно, поскольку кодировать данные

<function>urlencode</function> это обязанность браузера. Популярные

браузеры делают это правильно.

Заметьте, что это произойдёт независимо от метода (например,

GET или POST). Это заметно только в случае GET-запроса,

поскольку POST-запросы обычно скрыты.

</simpara>

</note>

<example>

<title>Данные, которые редактирует пользователь</title>

<programlisting role="php">

<![CDATA[

<?php

echo "<textarea name='mydata'>\n";

echo htmlspecialchars($data) . "\n";

echo "</textarea>";

?>

]]>

</programlisting>

</example>

<note>

<simpara>

Браузер показывает данные как предполагалось, потому что браузер

интерпретирует экранированные HTML-символы.

</simpara>

<simpara>

При отправке через GET- или POST-метод браузер закодирует (urlencoded)

данные для передачи, а PHP декодирует (urldecoded). Поэтому

не нужно выполнять какое-либо кодирование или декодирование,

всё обрабатываются автоматически.

</simpara>

</note>

<example>

<title>В URL</title>

<programlisting role="php">

<![CDATA[

<?php

echo '<a href="' . htmlspecialchars("/nextpage.php?stage=23&data=" .

urlencode($data)) . '">' . "\n"

;

?>

]]>

</programlisting>

</example>

<note>

<simpara>

На самом деле вы подделываете HTML-запрос GET, поэтому необходимо

вручную закодировать (<function>urlencode</function>) данные.

</simpara>

</note>

<note>

<simpara>

Вам надо применить функцию <function>htmlspecialchars</function>

к полному URL-адресу, потому что URL-адрес появляется как значение HTML-атрибута.

При этом браузер сначала раскодирует всё значение

(операция, обратная действию функции <function>htmlspecialchars</function>) и затем передаст URL.

PHP поймёт URL-адрес правильно, поскольку вы закодировали данные

функцией <function>urlencode</function>.

</simpara>

<simpara>

Вы заметите, что символ <literal>&amp;</literal> в URL-адресе заменяется на

мнемонику <literal>&amp;amp;</literal>. Хотя большинство браузеров это исправит,

если вы забудете об этом, но всё же это не всегда возможно. Поэтому,

даже если ваш URL-адрес не динамический, <emphasis>нужно</emphasis>

закодировать его функцией <function>htmlspecialchars</function>.

</simpara>

</note>

</para>

<!-- TODO: a note about addgpcslashes? -->

</answer>

</qandaentry>

<qandaentry xml:id="faq.html.form-image">

<question>

<para>

Я пытаюсь использовать &lt;input type="image"&gt;, но переменные

<varname>$foo.x</varname> и <varname>$foo.y</varname>

недоступны. Значение <varname>$_GET['foo.x']</varname> тоже не существует.

Где они?

</para>

</question>

<answer>

<para>

При отправке формы, вместо стандартной кнопки отправки допустимо использовать

изображение с тэгом вроде такого:

<programlisting role="html">

<![CDATA[

<input type="image" src="image.gif" name="foo" />

]]>

</programlisting>

Когда пользователь кликает по изображению, серверу будет послана

сопутствующая форма с двумя дополнительными переменными:

<varname>foo.x</varname> и <varname>foo.y</varname>.

</para>

<para>

Поскольку имена <varname>foo.x</varname> и <varname>foo.y</varname>

не разрешены в PHP, они автоматически преобразовываются в

<varname>foo_x</varname> и <varname>foo_y</varname>. То есть

точки заменяются на подчёркивания. Таким образом, вы обращаетесь к этим переменным

так же, как и к любым другим, описанным в разделе о получении

<link linkend="language.variables.external">переменных извне

PHP</link>. Например, <varname>$_GET['foo_x']</varname>.

<note>

<para>

Пробелы в именах переменных запроса преобразовываются в подчёркивания.

</para>

</note>

</para>

</answer>

</qandaentry>

<qandaentry xml:id="faq.html.arrays">

<question>

<para>Как создать массивы в HTML &lt;form&gt;?</para>

</question>

<answer>

<para>

Чтобы браузер передал результат &lt;form&gt; в PHP-скрипт

как <link linkend="language.types.array">массив</link>,

элементы &lt;input&gt;, &lt;select&gt; или &lt;textarea&gt; называют

следующим образом:

<programlisting role="html">

<![CDATA[

<input name="MyArray[]" />

<input name="MyArray[]" />

<input name="MyArray[]" />

<input name="MyArray[]" />

]]>

</programlisting>

Обратите внимание на квадратные скобки после имени переменной: они делают переменную массивом.

Разработчику доступна группировка элементов в массив за счёт присваивания одинакового имени

разным элементам:

<programlisting role="html">

<![CDATA[

<input name="MyArray[]" />

<input name="MyArray[]" />

<input name="MyOtherArray[]" />

<input name="MyOtherArray[]" />

]]>

</programlisting>

Это создаст два массива, MyArray и MyOtherArray, которые браузер передаст

PHP-скрипту. Можно также задать конкретные ключи для массивов:

<programlisting role="html">

<![CDATA[

<input name="AnotherArray[]" />

<input name="AnotherArray[]" />

<input name="AnotherArray[email]" />

<input name="AnotherArray[phone]" />

]]>

</programlisting>

Массив AnotherArray теперь будет содержать ключи 0, 1, email и phone.

</para>

<para>

<note>

<para>

Определять ключи массивов в HTML необязательно. Если вы не установите

ключи, массив заполнится в порядке появления элементов в форме.

Первый пример будет содержать ключи 0, 1, 2 и 3.

</para>

</note>

</para>

<para>

Также смотрите

<link linkend="ref.array">Функции для работы с массивами</link> и

<link linkend="language.variables.external">Переменные извне PHP</link>.

</para>

</answer>

</qandaentry>

<qandaentry xml:id="faq.html.select-multiple">

<question>

<para>

Как получить все результаты из HTML-тега select с атрибутом multiple?

</para>

</question>

<answer>

<para>

HTML-тег select с атрибутом multiple разрешает пользователю выбрать

элементы из списка. Эти элементы затем передаются обработчику

формы. Проблема в том, что они переданы с одним и тем же именем.

Например:

<programlisting role="html">

<![CDATA[

<select name="var" multiple="yes">

]]>

</programlisting>

Каждая выбранная опция поступит обработчику формы как:

<programlisting>

var=option1

var=option2

var=option3

</programlisting>

Каждая опция будет перезаписывать содержимое предыдущей переменной

<varname>$var</varname>. Решение — использовать функцию

PHP «массив из элемента формы». Как в следующем примере:

<programlisting role="html">

<![CDATA[

<select name="var[]" multiple="yes">

]]>

</programlisting>

Это говорит PHP рассматривать переменную <varname>$var</varname> как массив и

каждое присваивание значения для var[] добавляет элемент в массив.

Первым элементом будет <varname>$var[0]</varname>, следующим —

<varname>$var[1]</varname> и т. д. Можно использовать функцию <function>count</function>,

чтобы определить, сколько элементов было выбрано,

а функцию <function>sort</function> — для сортировки массива опций, если это необходимо.

</para>

<para>

Заметьте, если вы используете JavaScript, есть риск того, что запись <literal>[]</literal>

в имени элемента вызовет проблемы, если вы пытаетесь обращаться к

элементу по имени. Вместо этого указывайте числовой идентификатор элемента формы или

возьмите имя переменной в одинарные кавычки и используйте его как

индекс массива элементов, например:

<programlisting>

variable = document.forms[0].elements['var[]'];

</programlisting>

</para>

</answer>

</qandaentry>

<qandaentry xml:id="faq.html.javascript-variable">

<question>

<para>

Как передать переменную из JavaScript в PHP?

</para>

</question>

<answer>

<para>

Поскольку JavaScript — обычно клиентская технология,

а PHP, как правило, серверная, и поскольку

HTML — протокол «без состояния», эти два языка не умеют обмениваться

переменными напрямую.

</para>

<para>

Однако можно передавать переменные между ними.

Один из способов добиться этого — сгенерировать JavaScript-код

из PHP и принудительно обновлять браузер, посылая определённые

переменные обратно PHP-скрипту. Пример показывает,

как это сделать — он разрешает PHP-коду захватывать высоту и ширину

экрана, что обычно возможно только на стороне клиента.

</para>

<para>

<example>

<title>Генерирование JavaScript из PHP</title>

<programlisting role="php">

<![CDATA[

<?php

if (isset($_GET['width']) AND isset($_GET['height'])) {

// Выводим переменные с размерами

echo "Ширина экрана: " . $_GET['width'] . "<br />\n";

echo "Высота экрана: " . $_GET['height'] . "<br />\n";

} else {

// Передаём переменные с размерами

// (сохраняем оригинальную строку запроса

// — POST-переменные нужно будет передавать другим способом)

echo "<script>\n";

echo " location.href = \"{$_SERVER['SCRIPT_NAME']}?{$_SERVER['QUERY_STRING']}"

. "&width=\" + screen.width + \"&height=\" + screen.height;\n";

echo "</script>\n";

exit;

}

?>

]]>

</programlisting>

</example>

</para>

</answer>

</qandaentry>

</qandaset>

</chapter>

<!-- Keep this comment at the end of the file

Local variables:

mode: sgml

sgml-omittag:t

sgml-shorttag:t

sgml-minimize-attributes:nil

sgml-always-quote-attributes:t

sgml-indent-step:1

sgml-indent-data:t

indent-tabs-mode:nil

sgml-parent-document:nil

sgml-default-dtd-file:"~/.phpdoc/manual.ced"

sgml-exposed-tags:nil

sgml-local-catalogs:nil

sgml-local-ecat-files:nil

End:

vim600: syn=xml fen fdm=syntax fdl=2 si

vim: et tw=78 syn=sgml

vi: ts=1 sw=1

-->