mirror of
https://github.com/php/doc-ja.git
synced 2026-03-23 22:52:11 +01:00
0115bb427d
* コアと移行ガイドを英語版の最新に追従 language/ コア: - language/operators/precedence.xml: パイプ演算子と throw を追加 - language/predefined/generator/rewind.xml: 説明文を修正 - language/predefined/iterator/rewind.xml: rewind の注意事項を追加 - language/predefined/variables/server.xml: REQUEST_TIME の説明を修正 - faq/using.xml: 名前付き引数とプリペアドステートメントの推奨を追加 - language/predefined/closure.xml: Closure::getCurrent を追加 - language/control-structures/do-while.xml: インデント修正 - language/oop5/property-hooks.xml: 不足していた $modified プロパティを追加 reference/, appendices/: - reference/opcache/ini.xml: 最適化パスのビットマスク表を追加 - appendices/reserved.constants.core.xml: PHP_BUILD_DATE, PHP_BUILD_PROVIDER を追加 - appendices/migration85/incompatible.xml: setlocale の整数引数の変更を追加 - reference/strings/functions/setlocale.xml: 変更履歴セクションを追加 * 用語の統一（オプティマイザー→最適化エンジン）
387 lines
15 KiB
XML
387 lines
15 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
||
<!-- $Revision$ -->
|
||
<!-- EN-Revision: 1709768e97fce7848c62aa2bf988419527bd1e8e Maintainer: hirokawa Status: ready -->
|
||
<!-- CREDITS: takagi,mumumu -->
|
||
|
||
<chapter xml:id="faq.using" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||
<title>PHP の使いかた</title>
|
||
<titleabbrev>PHP の使いかた</titleabbrev>
|
||
|
||
<para>
|
||
このセクションにはPHPスクリプトを書くにあたってよく問題となる事柄が
|
||
集められています。
|
||
</para>
|
||
|
||
<qandaset>
|
||
|
||
<qandaentry xml:id="faq.using.parameterorder">
|
||
<question>
|
||
<para>
|
||
PHP の関数のパラメータの順番を覚えられません。だって関数によってばらばらなんだもん。
|
||
</para>
|
||
</question>
|
||
<answer>
|
||
<para>
|
||
PHP は、さまざまな外部ライブラリの間を取り持つ糊のような存在です。
|
||
そのため、時にはちょっとごちゃごちゃすることもあります。
|
||
しかし、経験上、以下のような規則があるようです。
|
||
</para>
|
||
<para>
|
||
<link linkend="book.array">配列関数</link> のパラメータは
|
||
"<emphasis>needle, haystack</emphasis>" の順だけれども、
|
||
<link linkend="book.strings">文字列関数</link> はその逆で
|
||
"<emphasis>haystack, needle</emphasis>" の順となります。
|
||
</para>
|
||
<para>
|
||
PHP 8.0 以降では、<link linkend="functions.named-arguments">名前付き引数</link>
|
||
によってパラメータ名で引数を渡すことができるため、パラメータの順序をそれほど気にする必要はありません。
|
||
</para>
|
||
</answer>
|
||
</qandaentry>
|
||
|
||
<qandaentry xml:id="faq.using.anyform">
|
||
<question>
|
||
<para>
|
||
あらゆるフォームから送信されたデータを扱うことができる汎用的な
|
||
PHPスクリプトを書きたいのですが、POSTメソッドでどのようなデータ
|
||
が送信されたかを知るにはどうするのですか？
|
||
</para>
|
||
</question>
|
||
<answer>
|
||
<para>
|
||
PHPは<varname>$_POST</varname>のような
|
||
<link linkend="language.variables.predefined">定義済みの変数</link>
|
||
を沢山提供しています。<varname>$_POST</varname> を連想配列として
|
||
ループすることでPOSTされた全ての値にアクセスできます。例えば、
|
||
&foreach; で単純にループして <function>empty</function> で値をチェックし、
|
||
結果を出力します。
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<?php
|
||
$empty = $post = array();
|
||
foreach ($_POST as $varname => $varvalue) {
|
||
if (empty($varvalue)) {
|
||
$empty[$varname] = $varvalue;
|
||
} else {
|
||
$post[$varname] = $varvalue;
|
||
}
|
||
}
|
||
|
||
print "<pre>";
|
||
if (empty($empty)) {
|
||
print "None of the POSTed values are empty, posted:\n";
|
||
var_dump($post);
|
||
} else {
|
||
print "We have " . count($empty) . " empty values\n";
|
||
print "Posted:\n"; var_dump($post);
|
||
print "Empty:\n"; var_dump($empty);
|
||
exit;
|
||
}
|
||
?>
|
||
]]>
|
||
</programlisting>
|
||
</para>
|
||
|
||
</answer>
|
||
</qandaentry>
|
||
|
||
<qandaentry xml:id="faq.using.singlequotes">
|
||
<question>
|
||
<para>
|
||
シングルクオート(')をバックスラッシュでエスケープされた
|
||
シングルクオート(\')に変換しなければならないのですが、
|
||
正規表現を用いてこれを行うにはどの様にするのですか？
|
||
同様に " を \" に、\ を \\ に変換したいのです。
|
||
</para>
|
||
</question>
|
||
<answer>
|
||
<para>
|
||
もしデータベースに格納するためにそんなことをしようとしているのなら、
|
||
データベース自身が持つエスケープの仕組みを使うようにしましょう。
|
||
MySQL なら <function>mysql_real_escape_string</function>、
|
||
PostgreSQL なら <function>pg_escape_string</function> などです。
|
||
汎用的な関数 <function>addslashes</function> や
|
||
<function>stripslashes</function> もありますが、
|
||
これはさらに古い時代の PHP コードで使われていたものです。
|
||
</para>
|
||
<para>
|
||
手動で値をエスケープする方法はエラーが発生しやすく、コンテキストに依存します。
|
||
エスケープした文字列を連結してクエリを組み立てるのではなく、
|
||
プリペアドステートメントとパラメータバインディングをサポートする
|
||
データベース API を使うようにしてください。
|
||
</para>
|
||
</answer>
|
||
</qandaentry>
|
||
|
||
<qandaentry xml:id="faq.using.wrong-order">
|
||
<question>
|
||
<para>
|
||
次のようなコードを実行すると、思った通りの順番で出力が表示されません。
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
function myfunc($argument)
|
||
{
|
||
echo $argument + 10;
|
||
}
|
||
$variable = 10;
|
||
echo "myfunc($variable) = " . myfunc($variable);
|
||
]]>
|
||
</programlisting>
|
||
なぜですか？
|
||
</para>
|
||
</question>
|
||
<answer>
|
||
<para>
|
||
式の中で関数の実行結果を使用する(例えば上の例の様に他の文字列と
|
||
連結する)ためには、<function>echo</function> するのではなく、その
|
||
値を <function>return</function> しなければいけません。
|
||
</para>
|
||
</answer>
|
||
</qandaentry>
|
||
|
||
<qandaentry xml:id="faq.using.newlines">
|
||
<question>
|
||
<para>
|
||
改行されないのですが？
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
<pre>
|
||
<?php echo "これは1行目"; ?>
|
||
<?php echo "この行は改行に続いて出力されるはず"; ?>
|
||
</pre>
|
||
]]>
|
||
</programlisting>
|
||
</para>
|
||
</question>
|
||
<answer>
|
||
<para>
|
||
PHPでは、"?>"か"?>\n"(\nは改行を表します)をPHPのコードブロッ
|
||
クの終端と見なします。このため、コードブロック終端の改行記号は省
|
||
略され、表示される文は1行になります。つまり、改行をさせるために
|
||
は、PHPのコードブロックの終端の後にもう1つ改行を挿入する必要があ
|
||
るということです。
|
||
</para>
|
||
<para>
|
||
なぜPHPはこのようなことをするのでしょうか？なぜならHTMLを出力する
|
||
場合にはこの方が都合のよいことが多いからです。もしとても長い1行を
|
||
出力しなければならない場合に、改行が解釈されてしまうとしたらどう
|
||
でしょう。ソースコードの1行もとても読めないくらい長いものになって
|
||
しまいます。
|
||
</para>
|
||
</answer>
|
||
</qandaentry>
|
||
|
||
<qandaentry xml:id="faq.using.headers-sent">
|
||
<question>
|
||
<para>
|
||
'Warning: Cannot send session cookie - headers already sent...'や
|
||
'Cannot add header information - headers already set...'といった
|
||
メッセージが出力されるのですが。
|
||
sent...'.
|
||
</para>
|
||
</question>
|
||
<answer>
|
||
<para>
|
||
<function>header</function>, <function>set_cookie</function>や
|
||
<link linkend="ref.session">セッション関数</link>は出力ストリームに
|
||
ヘッダを付加する関数で、ヘッダを送信できるのは本文の出力を
|
||
開始する前のみです。<function>headers_sent</function>を使って
|
||
既にヘッダが送信済みでないかチェックすることができます。
|
||
<link linkend="ref.outcontrol">出力制御関数</link>もご覧ください。
|
||
</para>
|
||
</answer>
|
||
</qandaentry>
|
||
|
||
<qandaentry xml:id="faq.using.header">
|
||
<question>
|
||
<para>
|
||
リクエストヘッダに直接アクセスしたいのですが、どうすればよいですか？
|
||
</para>
|
||
</question>
|
||
<answer>
|
||
<para>
|
||
もしPHPがApacheモジュールとして動作しているなら、
|
||
<function>getallheaders</function>を使えば全てのヘッダを取得する
|
||
ことができます。下のちょっとしたコードで全てのリクエストヘッダを
|
||
表示することができます。
|
||
<programlisting role="php">
|
||
<![CDATA[
|
||
$headers = getallheaders();
|
||
foreach ($headers as $name => $content) {
|
||
echo "headers[$name] = $content<br />\n";
|
||
}
|
||
]]>
|
||
</programlisting>
|
||
</para>
|
||
<para>
|
||
<function>apache_lookup_uri</function>,
|
||
<function>apache_response_headers</function>,
|
||
<function>fsockopen</function>も参照ください。
|
||
</para>
|
||
</answer>
|
||
</qandaentry>
|
||
|
||
<qandaentry xml:id="faq.using.authentication">
|
||
<question>
|
||
<para>
|
||
IISで認証を行おうとすると'No Input file specified'というエラーが
|
||
発生します。
|
||
</para>
|
||
</question>
|
||
<answer>
|
||
<para>
|
||
これはIISのセキュリティモデルの欠点で、IISで動作するCGIに共通する
|
||
問題です。これを回避策するには、認証のかかったディレクトリに(PHP
|
||
が解釈しない)HTMLファイルを作成します。そしてMETAタグを使ってPHP
|
||
を使用したページにリダイレクトするか、リンクを張ります。こうすれ
|
||
ばPHPは認証済みかどうかを正しく認識することが出来ます。
|
||
また、これは他のNTウェブサーバーに
|
||
は影響ありません。詳しくは<link xlink:href="&url.iis;">&url.iis;</link>
|
||
と<link linkend="features.http-auth">HTTP 認証</link>を
|
||
参照ください。
|
||
</para>
|
||
</answer>
|
||
</qandaentry>
|
||
|
||
<qandaentry xml:id="faq.using.iis.sharing">
|
||
<question>
|
||
<para>
|
||
Windows: 他のコンピュータと共有しているファイルに、IIS
|
||
でアクセスできません。
|
||
</para>
|
||
</question>
|
||
<answer>
|
||
<para>
|
||
<literal>Go to Internet Information
|
||
Services</literal> を変更する必要があります。PHP ファイルを選択して
|
||
プロパティを開き、<literal>セキュリティ</literal> タブに移動し、
|
||
<literal>Edit -< Anonymous access and authentication control</literal> 。
|
||
</para>
|
||
<para>
|
||
この問題を解決するには <literal>Anonymous
|
||
Access</literal> のチェックをはずして <literal>Integrated Window
|
||
Authentication</literal> をチェックしたままにしておきか、
|
||
あるいは <literal>Anonymous
|
||
Access</literal> をチェックしてアクセスできないユーザーを別途指定します。
|
||
</para>
|
||
</answer>
|
||
</qandaentry>
|
||
|
||
<qandaentry xml:id="faq.using.mixml">
|
||
<question>
|
||
<para>
|
||
どうすればXMLとPHPは共存することが出来るのですか？XMLの
|
||
<?xml>タグがPHPでエラーになります。
|
||
</para>
|
||
</question>
|
||
<answer>
|
||
<para>
|
||
<?xml を直接PHPコードに埋め込むには、
|
||
PHPディレクティブの<link linkend="ini.short-open-tag">short_tags</link>
|
||
を <literal>0</literal> に設定しなければなりません。
|
||
このディレクティブは<function>ini_set</function>でセットすることは
|
||
できません。<link linkend="ini.short-open-tag">short_open_tags</link>
|
||
のオン/オフに関わらず、次のようにもできます:
|
||
<literal><?php echo '<?xml'; ?></literal>
|
||
このディレクティブはデフォルトでオンです。
|
||
</para>
|
||
</answer>
|
||
</qandaentry>
|
||
|
||
<qandaentry xml:id="faq.using.variables">
|
||
<question>
|
||
<para>
|
||
あらかじめ設定されている変数を全て網羅したリストはどこにあるので
|
||
すか？なぜPHPのドキュメントにはその一覧がないのですか？
|
||
</para>
|
||
</question>
|
||
<answer>
|
||
<para>
|
||
マニュアルの
|
||
<link linkend="language.variables.predefined">定義済みの変数</link>
|
||
のページを読んでください。スクリプト上で有効な定義済み変数のリストの
|
||
一部があります。有効な変数の完全なリスト（とその詳しい情報）は
|
||
<function>phpinfo</function>をコールすることで見ることができます。
|
||
マニュアルの
|
||
<link linkend="language.variables.external">PHPの外部から来る変数</link>
|
||
のセクションも読んでください。HTMLフォームやCookie、URL等から
|
||
来る外部変数に関するシナリオが説明されています。
|
||
</para>
|
||
</answer>
|
||
</qandaentry>
|
||
|
||
<qandaentry xml:id="faq.using.freepdf">
|
||
<question>
|
||
<para>
|
||
フリーではない商用ライブラリである
|
||
PDFLib を使わずに
|
||
PDFファイルを生成するにはどうしたらよいでしょうか？
|
||
フリーのもので、外部のPDFライブラリが不要なものがいいのですが。
|
||
</para>
|
||
</question>
|
||
<answer>
|
||
<para>
|
||
PHPで書かれている代替手段がいくつかあります。
|
||
<link xlink:href="&url.pdf.fpdf;">FPDF</link> や
|
||
<link xlink:href="&url.pdf.tcpdf;">TCPDF</link> などです。
|
||
</para>
|
||
</answer>
|
||
</qandaentry>
|
||
|
||
<qandaentry xml:id="faq.using.shorthandbytes">
|
||
<question>
|
||
<para>
|
||
いくつかの PHP ディレクティブでは、バイト値を <type>int</type>
|
||
ではなく省略形で設定できます。この省略形で使えるオプションを教えてください。
|
||
</para>
|
||
</question>
|
||
<answer>
|
||
<para>
|
||
有効なオプションは K（キロバイト）、M（メガバイト）および G（ギガバイト)
|
||
です。これらはすべて、大文字小文字を区別しません。
|
||
これ以外の文字はバイト値と判断されます。
|
||
<literal>1M</literal> は、1 メガバイトあるいは <literal>1048576</literal>
|
||
バイトと等しくなります。<literal>1K</literal> は、1 キロバイトあるいは
|
||
<literal>1024</literal> バイトです。この表記法は、 &php.ini;
|
||
や <function>ini_set</function> 関数で使えます。
|
||
ここで、数値の値は、<type>int</type>
|
||
型にキャストされることに注意して下さい。
|
||
たとえば、<literal>0.5M</literal> は <literal>0</literal>
|
||
と解釈されます。
|
||
</para>
|
||
<note>
|
||
<title>キロバイト? キビバイト?</title>
|
||
<para>
|
||
PHP の記法では 1 キロバイト = 1024 バイトとしていますが、
|
||
<acronym>IEC</acronym> の標準規格では 1024 バイトのことを
|
||
1 キビバイト (kibibyte) と呼ぶことになっています。
|
||
まとめ: PHP での k および K = 1024 バイト。
|
||
</para>
|
||
</note>
|
||
</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
|
||
-->
|