Skip to content

#257 で誤って翻訳がスキップされたコミットを翻訳 (part 1/2) #292

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
May 1, 2025
Merged

#257 で誤って翻訳がスキップされたコミットを翻訳 (part 1/2) #292

Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
fc587a9
language-snippets.ent: スキップされていた 8b502f81f951a1af64396b69823f7a35b763…
nsfisis Apr 27, 2025
6397156
language-snippets.ent: スキップされていた 9a5b92a30888d6423db112f07a9b344cf6fc…
nsfisis Apr 27, 2025
debef2b
language-snippets.ent: スキップされていた c75f19c74fa3b64abfafd7a35aaa652b0783…
nsfisis Apr 27, 2025
47885d2
language-snippets.ent: スキップされていた 53054bf8decc8648cf2e90a493692a161e23…
nsfisis Apr 27, 2025
4add6be
language-snippets.ent: スキップされていた ed1aff13602c94f86344bdd7c4fbc31f5a71…
nsfisis Apr 27, 2025
b4e2bcc
language-snippets.ent: スキップされていた bead080a991889bf281d32095f2197e61413…
nsfisis Apr 27, 2025
6d84746
language-snippets.ent: スキップされていた ebbc5bb97c8c063d31309725c0bb93d21213…
nsfisis Apr 27, 2025
6c4b413
language-snippets.ent: スキップされていた 810229e31c049ee7240aad2be5694fca7901…
nsfisis Apr 27, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
91 changes: 74 additions & 17 deletions language-snippets.ent
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -762,14 +762,8 @@ DLL ファイルを PHP のフォルダから Windows のシステムディレ
<!ENTITY style.oop 'オブジェクト指向型'>
<!ENTITY style.procedural '手続き型'>

<!ENTITY resource '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.resource">リソース</link>'>

<!ENTITY foreach '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.foreach">foreach</link>'>

<!ENTITY match '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.match">match</link>'>

<!ENTITY yield '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.yield">yield</link>'>

<!ENTITY parameter.context '<literal xmlns="http://docbook.org/ns/docbook">コンテキスト</literal> についての説明は、
マニュアルの <link xmlns="http://docbook.org/ns/docbook" linkend="context">コンテキスト</link> の節を参照ください。'>

Expand Down Expand Up @@ -1640,22 +1634,32 @@ object</parameter></term><listitem><para>手続き型のみ: <function>date_crea
が使えます。
</para>'>
<!ENTITY dom.note.utf8 '<note xmlns="http://docbook.org/ns/docbook"><para>DOM拡張モジュール は UTF-8 エンコーディングを使います。他のエンコーディングを扱う場合は、<function>mb_convert_encoding</function>, <methodname>UConverter::transcode</methodname>, <function>iconv</function> を使ってください。</para></note>'>
<!ENTITY dom.note.modern.utf8 '<note xmlns="http://docbook.org/ns/docbook">
<simpara>
DOM拡張モジュールは、メソッドやプロパティで UTF-8 エンコーディングを使います。
パースをおこなうメソッドは、エンコーディングを自動的に判別し、呼び出し側でエンコーディングを指定することもできます。
</simpara>
</note>'>
<!ENTITY dom.note.json '<note xmlns="http://docbook.org/ns/docbook"><para><classname>DOMDocument</classname> オブジェクトに対して <function>json_encode</function> を使うと、結果は空オブジェクトをエンコードしたものになります。</para></note>'>
<!ENTITY dom.domdocument.html5 '<warning xmlns="http://docbook.org/ns/docbook">
<para>
<simpara>
モダンな HTML をパースしたり処理したりするには、<classname>DOMDocument</classname> の代わりに
<classname>Dom\HTMLDocument</classname> を使ってください。
</simpara>
<simpara>
この関数は、HTML4 のパーサを使って入力をパースします。モダンなWebブラウザが採用している HTML5 のパースルールとは異なります。入力によっては、このことが原因で異なるDOM構造になるかもしれません。よって、この関数はHTMLを無害化する目的で安全に使えません。
</para>
<para>
</simpara>
<simpara>
HTML をパースする挙動は、利用している
<literal>libxml</literal> のバージョンに依存します。
特にエッジケースやエラーハンドリングについてそれが当てはまります。
HTML5 に準拠したパースを行うには、PHP 8.4 で追加される
<methodname>Dom\HTMLDocument::createFromString</methodname> や
<methodname>Dom\HTMLDocument::createFromFile</methodname> を使いましょう。
</para>
<para>
</simpara>
<simpara>
例を挙げましょう。HTML要素によっては、暗黙のうちに親の要素を閉じるものがあります。親要素を自動で閉じるルールは、HTML4 と HTML5 で異なります。よって、<classname>DOMDocument</classname> が表す DOM 構造は Webブラウザ上のそれと異なる可能性があります。このことから、攻撃者がHTMLを壊す攻撃を許す可能性があります。
</para>
</simpara>
</warning>'>


Expand Down Expand Up @@ -1800,9 +1804,15 @@ object</parameter></term><listitem><para>手続き型のみ: <function>date_crea
<!ENTITY haru.error '<para xmlns="http://docbook.org/ns/docbook">エラー時に <classname>HaruException</classname> をスローします。</para>'>

<!-- ODBC -->
<!ENTITY odbc.connection.id '<para xmlns="http://docbook.org/ns/docbook">ODBC 接続 ID。詳細は
<!ENTITY odbc.connection.id '<para xmlns="http://docbook.org/ns/docbook">ODBC 接続オブジェクト。詳細は
<function>odbc_connect</function> を参照ください。</para>'>

<!ENTITY odbc.result.object 'ODBC 結果オブジェクト'>

<!ENTITY odbc.result.object-return 'ODBC 結果オブジェクトを返します'>

<!ENTITY odbc.result.object-return-falseforfailure '&odbc.result.object-return;。&return.falseforfailure;。'>

<!ENTITY odbc.parameter.catalog 'カタログ(ODBC 2 の用語では &apos;修飾子&apos;)。'>

<!ENTITY odbc.parameter.schema 'スキーマ (ODBC 2 の用語では &apos;所有者&apos;)。'>
Expand All @@ -1813,6 +1823,39 @@ object</parameter></term><listitem><para>手続き型のみ: <function>date_crea

<!ENTITY odbc.result.driver-specific 'ドライバは追加のカラムを返すことが出来ます。'>

<!ENTITY odbc.changelog.connection-param '<row xmlns="http://docbook.org/ns/docbook">
<entry>8.4.0</entry>
<entry>
引数 <parameter>odbc</parameter> は、<classname>Odbc\Connection</classname> クラスのインスタンスを期待するようになりました。
これより前のバージョンでは、<type>resource</type> を期待していました。
</entry>
</row>'>

<!ENTITY odbc.changelog.connection-return '&odbc.changelog.connection-param;
<row xmlns="http://docbook.org/ns/docbook">
<entry>8.4.0</entry>
<entry>
この関数は <classname>Odbc\Connection</classname> クラスのインスタンスを返すようになりました。
これより前のバージョンでは、<type>resource</type> を返していました。
</entry>
</row>'>

<!ENTITY odbc.changelog.result-param '<row xmlns="http://docbook.org/ns/docbook">
<entry>8.4.0</entry>
<entry>
引数 <parameter>statement</parameter> は、<classname>Odbc\Result</classname> クラスのインスタンスを期待するようになりました。
これより前のバージョンでは、<type>resource</type> を期待していました。
</entry>
</row>'>

<!ENTITY odbc.changelog.result-return '<row xmlns="http://docbook.org/ns/docbook">
<entry>8.4.0</entry>
<entry>
この関数は <classname>Odbc\Result</classname> クラスのインスタンスを返すようになりました。
これより前のバージョンでは、<type>resource</type> を返していました。
</entry>
</row>'>

<!-- OAUTH -->
<!ENTITY oauth.callback.error 'コールバック関数をコールできなかったり、
あるいは定義されていなかったりした場合は <constant xmlns="http://docbook.org/ns/docbook">E_ERROR</constant>
Expand Down Expand Up @@ -2052,6 +2095,10 @@ PECL 拡張モジュールのインストール</link> という章にありま
この拡張モジュールは &link.pecl; レポジトリに移動
されており、以下のバージョン以降 PHP にバンドルされなくなっています。 PHP '>

<!ENTITY warn.pecl.unmaintained '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>この拡張モジュールは、<emphasis>メンテナンスされていません</emphasis>。</simpara>
</warning>'>

<!-- PGSQL entities -->

<!ENTITY pgsql.parameter.connection '<para xmlns="http://docbook.org/ns/docbook"><classname>PgSql\Connection</classname> クラスのインスタンス。</para>'>
Expand Down Expand Up @@ -2146,6 +2193,12 @@ PHP 8.1.0 以降は、ctype関数 に文字列でない引数を渡すことは
<!-- GMP Notes -->
<!ENTITY gmp.return '<classname xmlns="http://docbook.org/ns/docbook">GMP</classname> オブジェクトを返します。'>
<!ENTITY gmp.parameter '<para xmlns="http://docbook.org/ns/docbook"><classname>GMP</classname> オブジェクト、整数、あるいは数値に変換可能な数値形式の文字列。</para>'>
<!ENTITY gmp.parameter '<para xmlns="http://docbook.org/ns/docbook">
<classname>GMP</classname> オブジェクト、&integer;、
あるいは数値として解釈可能な &string;。
文字列の場合、<function>gmp_init</function> で基数を自動検出するとき
(<parameter>base</parameter> に 0 を指定したとき) と同じ方法で解釈されます。
</para>'>

<!-- MySQLi Notes -->
<!ENTITY mysqli.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>result</parameter></term><listitem>
Expand Down Expand Up @@ -4931,17 +4984,21 @@ local: {
'>

<!-- filter snippets -->
<!-- TODO: Remove -->
<!ENTITY filter.param.filter '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>filter</parameter></term>
<listitem>
<para>
適用するフィルタの ID。<xref linkend="filter.filters" />
に、利用できるフィルタの一覧があります。
適用するフィルタ。
<constant>FILTER_VALIDATE_<replaceable>*</replaceable></constant> 定数の一つを用いた検証フィルタ、
<constant>FILTER_SANITIZE_<replaceable>*</replaceable></constant> 定数の一つを用いた除去フィルタ、
<constant>FILTER_UNSAFE_RAW</constant>、
<constant>FILTER_CALLBACK</constant> を用いたカスタムフィルタのいずれかを指定できます。
</para>
<para>
省略した場合は <constant>FILTER_DEFAULT</constant> を使います。これは
<link linkend="filter.filters.sanitize"><constant>FILTER_UNSAFE_RAW</constant></link> と同等です。
デフォルトの値は <constant>FILTER_DEFAULT</constant> で、
これは <constant>FILTER_UNSAFE_RAW</constant> のエイリアスです。
結果的に、デフォルトでは何もフィルタリングをしません。
</para>
</listitem>
Expand Down