Skip to content

doc-en と同期し 11 モジュールを完訳（既訳更新 15 件・新規翻訳 2 件） #382

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
KentarouTakeda merged 1 commit into from
Jun 2, 2026
Merged

doc-en と同期し 11 モジュールを完訳（既訳更新 15 件・新規翻訳 2 件） #382

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
5 changes: 4 additions & 1 deletion appendices/migration85/constants.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: ec45af749649dc0d6a23eaedeed1b601f7460813 Maintainer: mumumu Status: ready -->
<!-- EN-Revision: f8bab1dfb5246788f144103de56208dd133e9461 Maintainer: mumumu Status: ready -->
<sect1 xml:id="migration85.constants">
<title>新しいグローバル定数</title>

Expand Down Expand Up @@ -162,6 +162,9 @@
<title>Standard</title>

<simplelist>
<member>
<constant>IMAGETYPE_HEIF</constant>
</member>
<member>
<constant>IMAGETYPE_SVG</constant>
when libxml is loaded.
Expand Down
26 changes: 24 additions & 2 deletions reference/exec/functions/proc-close.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 350d95443aeb0ea8751d71f262aac56d3ad48f83 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: ef623ccf442df416da4e5bc254b4c5d4f6df9475 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka,mumumu -->
<!-- splitted from ./en/functions/exec.xml, last change in rev 1.28 -->
<refentry xml:id='function.proc-close' xmlns="http://docbook.org/ns/docbook">
Expand Down Expand Up @@ -51,7 +51,29 @@
</para>
&note.sigchild;
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.3.0</entry>
<entry>
先に <function>proc_get_status</function> が呼び出された後でも、
<function>proc_close</function> は正しい終了コードを返すようになりました。
これより前のバージョンでは、<literal>-1</literal> を返していました。
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Expand Down
12 changes: 11 additions & 1 deletion reference/exif/functions/exif-imagetype.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6a08181be1706dfebdb3ad6e45620bceb08019ba Maintainer: takagi Status: ready -->
<!-- EN-Revision: f8bab1dfb5246788f144103de56208dd133e9461 Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.exif-imagetype">
<refnamediv>
Expand Down Expand Up @@ -137,6 +137,10 @@
<entry>19</entry>
<entry><constant>IMAGETYPE_AVIF</constant></entry>
</row>
<row>
<entry>20</entry>
<entry><constant>IMAGETYPE_HEIF</constant></entry>
</row>
</tbody>
</tgroup>
</table>
Expand Down Expand Up @@ -175,6 +179,12 @@
AVIF をサポートしました。
</entry>
</row>
<row>
<entry>8.5.0</entry>
<entry>
HEIF をサポートしました。
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
Expand Down
106 changes: 52 additions & 54 deletions reference/filesystem/functions/fscanf.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 4225e50bc391ddba99e367c231463da0dc04357d Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 9947012f745f0fb6e083bce5a8c920213ff468b7 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka,mumumu -->
<refentry xml:id="function.fscanf" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand All @@ -16,66 +16,69 @@
<methodparam><type>string</type><parameter>format</parameter></methodparam>
<methodparam rep="repeat"><type>mixed</type><parameter role="reference">vars</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
関数<function>fscanf</function> は <function>sscanf</function>
に似ていますが、<parameter>stream</parameter> が指すファイルから入力を取得し、
指定したフォーマット <parameter>format</parameter> に基づき解釈を行います。
</para>
<para>
</simpara>
<simpara>
フォーマット文字列におけるあらゆる空白は
入力ストリームのあらゆる空白にマッチします。
これはつまりフォーマット文字列のタブ (<literal>\t</literal>) すらも
入力ストリームの空白1個にマッチしてしまうことを意味します。
</para>
<para>
</simpara>
<simpara>
<function>fscanf</function> をコールするたびに、ファイルから 1 行ずつ読み込みます。
</para>
</simpara>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>stream</parameter></term>
<listitem>
&fs.file.pointer;
</listitem>
</varlistentry>
&strings.scanf.parameter.format;
<varlistentry>
<term><parameter>vars</parameter></term>
<listitem>
<para>
オプションで代入する値。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>stream</parameter></term>
<listitem>
&fs.file.pointer;
</listitem>
</varlistentry>
&strings.scanf.parameter.format;
<varlistentry>
<term><parameter>vars</parameter></term>
<listitem>
<simpara>
オプションで代入する値。
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
この関数のパラメータが二つだけの場合、処理された値は配列として返されます。
他方、オプションのパラメータが指定された場合、
この関数は、代入された値の数を返します。
オプション引数は参照渡しとする必要があります。
</para>
<para>
</simpara>
<simpara>
<parameter>string</parameter> で利用可能な部分文字列よりも、
<parameter>format</parameter> で期待された部分文字列の数が多い場合は、&null; が返されます。
その他のエラーが発生した場合は、&false; が返されます。
</para>
</simpara>
<simpara>
オプションのパラメータを使用していて、
いずれかの値がパースされる前に
<parameter>stream</parameter> から読み込んだ入力の終端に達した場合は、
<literal>-1</literal> が返されます。
</simpara>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>fscanf</function> の例</title>
<programlisting role="php">
<example>
<title><function>fscanf</function> の例</title>
<programlisting role="php">
<![CDATA[
<?php
$handle = fopen("users.txt", "r");
Expand All @@ -86,36 +89,31 @@ while ($userinfo = fscanf($handle, "%s\t%s\t%s\n")) {
fclose($handle);
?>
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>users.txt の内容</title>
<programlisting role="txt">
</programlisting>
</example>
<example>
<title>users.txt の内容</title>
<programlisting role="txt">
<![CDATA[
javier argonaut pe
hiroshi sculptor jp
robert slacker us
luigi florist it
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>fread</function></member>
<member><function>fgets</function></member>
<member><function>fgetss</function></member>
<member><function>sscanf</function></member>
<member><function>printf</function></member>
<member><function>sprintf</function></member>
</simplelist>
</para>
<simplelist>
<member><function>fread</function></member>
<member><function>fgets</function></member>
<member><function>fgetss</function></member>
<member><function>sscanf</function></member>
<member><function>printf</function></member>
<member><function>sprintf</function></member>
</simplelist>
</refsect1>

</refentry>
Expand Down
11 changes: 10 additions & 1 deletion reference/funchand/functions/register-shutdown-function.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b412bbd26214f7281ac7dd858710e09952a275f2 Maintainer: takagi Status: ready -->
<!-- EN-Revision: 2312f826e5fdedbef87c6288c2c20f9f904b4d0b Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xml:id="function.register-shutdown-function" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand All @@ -25,6 +25,15 @@
登録した関数内で <function>exit</function> をコールした場合、
処理はそこで終了してその他のシャットダウン関数はコールされません。
</para>
<caution>
<simpara>
PHP 8.4.0 以降は、登録したシャットダウン関数内で引数なしの
<function>exit</function> をコールすると、終了コードが
<literal>0</literal> にリセットされます。
明示的にステータスを指定して <function>exit</function> をコールした場合は、
すべてのバージョンで、それ以前の終了コードが上書きされます。
</simpara>
</caution>
<para>
シャットダウン関数は、
別のシャットダウン関数をキューの最後に追加するために、
Expand Down
18 changes: 13 additions & 5 deletions reference/hash/functions/hash.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 539a9823a805ac29cab7fa4baf3ae3a28116a2f5 Maintainer: takagi Status: ready -->
<!-- EN-Revision: df2a77acbbb9d381426b863fcfa4d66ac7f5ab6d Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<refentry xml:id="function.hash" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -71,7 +71,15 @@
そのままのバイナリ形式で返されます。
</para>
</refsect1>


<refsect1 role="errors">
&reftitle.errors;
<simpara>
<parameter>algo</parameter> が不明な場合、
<exceptionname>ValueError</exceptionname> がスローされます。
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<para>
Expand All @@ -90,10 +98,10 @@
<row>
<entry>8.0.0</entry>
<entry>
<function>hash</function> は、
<parameter>algo</parameter> が未知の場合に、
<classname>ValueError</classname> をスローするようになりました。
これより前のバージョンでは、&false; を返していました。
<exceptionname>ValueError</exceptionname> をスローするようになりました。
これより前のバージョンでは、&false; を返し、
<constant>E_WARNING</constant> メッセージを発行していました。
</entry>
</row>
</tbody>
Expand Down
14 changes: 13 additions & 1 deletion reference/image/constants.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 7f5d646f3ee39231150e767fb876b56610f56c2b Maintainer: takagi Status: ready -->
<!-- EN-Revision: f8bab1dfb5246788f144103de56208dd133e9461 Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<appendix xml:id="image.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
Expand Down Expand Up @@ -703,6 +703,18 @@
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.imagetype-heif">
<term>
<constant>IMAGETYPE_HEIF</constant>
(<type>int</type>)
</term>
<listitem>
&gd.constants.type;
<simpara>
(PHP 8.5.0 以降で利用可能です)
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.imagetype-unknown">
<term>
<constant>IMAGETYPE_UNKNOWN</constant>
Expand Down
6 changes: 5 additions & 1 deletion reference/image/functions/image-type-to-mime-type.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: f8bab1dfb5246788f144103de56208dd133e9461 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka,mumumu -->
<refentry xml:id="function.image-type-to-mime-type" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -130,6 +130,10 @@
<entry><constant>IMAGETYPE_AVIF</constant></entry>
<entry><literal>image/avif</literal></entry>
</row>
<row>
<entry><constant>IMAGETYPE_HEIF</constant></entry>
<entry><literal>image/heif</literal></entry>
</row>
</tbody>
</tgroup>
</table>
Expand Down
8 changes: 7 additions & 1 deletion reference/image/functions/imagecopyresampled.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: fcd9214294f88b05862a538c6dd94c7872420139 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 16b6c3466bb70f2300b236273003f509638ebb90 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka,mumumu -->
<refentry xml:id="function.imagecopyresampled" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -143,6 +143,12 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
戻り値の型が、&true; になりました。これより前のバージョンでは、<type>bool</type> でした。
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Expand Down
Loading
Loading