svn: /phpdoc/ja/trunk/ language-snippets.ent reference/phar/Phar/addFile.xml reference/phar/Phar/addFromString.xml reference/phar/Phar/offsetSet.xml reference/phar/PharData/addFile.xml reference/phar/PharData/addFromString.xml reference/phar/PharData/offsetSet.xml
[email protected] (Yoshinari Takaoka) Mon, 28 Dec 2020 21:37:33 +0000
| Newsgroups | php.doc.ja |
|---|---|
| Message-ID | <[email protected]> |
mumumu Mon, 28 Dec 2020 21:37:33 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=352258
Log:
Fix #80399: Using PharData to create TAR files is super slow (at least 10x slower)
Bug: https://bugs.php.net/80399 (Closed) Using PharData to create TAR files is super slow (at least 10x slower)
Changed paths:
U phpdoc/ja/trunk/language-snippets.ent
U phpdoc/ja/trunk/reference/phar/Phar/addFile.xml
U phpdoc/ja/trunk/reference/phar/Phar/addFromString.xml
U phpdoc/ja/trunk/reference/phar/Phar/offsetSet.xml
U phpdoc/ja/trunk/reference/phar/PharData/addFile.xml
U phpdoc/ja/trunk/reference/phar/PharData/addFromString.xml
U phpdoc/ja/trunk/reference/phar/PharData/offsetSet.xml
Modified: phpdoc/ja/trunk/language-snippets.ent
===================================================================
--- phpdoc/ja/trunk/language-snippets.ent 2020-12-28 21:27:03 UTC (rev 352257)
+++ phpdoc/ja/trunk/language-snippets.ent 2020-12-28 21:37:33 UTC (rev 352258)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 352192 Maintainer: takagi Status: working -->
+<!-- EN-Revision: 352243 Maintainer: takagi Status: working -->
<!-- Credits: hirokawa,haruki,shimooka,mumumu -->
<!ENTITY installation.enabled.disable 'この拡張モジュールはデフォルトで有効になっています。無効にしたい場合は、次のオプションを指定してコンパイルします。'>
@@ -2129,6 +2129,20 @@
<function>PharFileInfo::decompress</function> および <function>PharFileInfo::compress</function>
をご利用ください。</para></note>'>
+<!ENTITY phar.note.performance '<note xmlns="http://docbook.org/ns/docbook">
+ <simpara>
+ <function>Phar::addFile</function>, <function>Phar::addFromString</function>, <function>Phar::offsetSet</function> は、呼び出されるたびに新しいPharアーカイブを生成します。パフォーマンスを気にするなら、代わりに
+ <function>Phar::buildFromDirectory</function> や <function>Phar::buildFromIterator</function> を使うべきです。
+ </simpara>
+</note>'>
+
+<!ENTITY phardata.note.performance '<note xmlns="http://docbook.org/ns/docbook">
+ <simpara>
+ <function>PharData::addFile</function>, <function>PharData::addFromString</function>, <function>PharData::offsetSet</function> は、呼び出されるたびに新しいPharアーカイブを生成します。パフォーマンスを気にするなら、代わりに
+ <function>PharData::buildFromDirectory</function> や <function>PharData::buildFromIterator</function> を使うべきです。
+ </simpara>
+</note>'>
+
<!-- XML -->
<!ENTITY libxml.required '<para xmlns="http://docbook.org/ns/docbook">この拡張モジュールを使うには
<link linkend="book.libxml">libxml</link> 拡張モジュールが必要です。つまり、
Modified: phpdoc/ja/trunk/reference/phar/Phar/addFile.xml
===================================================================
--- phpdoc/ja/trunk/reference/phar/Phar/addFile.xml 2020-12-28 21:27:03 UTC (rev 352257)
+++ phpdoc/ja/trunk/reference/phar/Phar/addFile.xml 2020-12-28 21:37:33 UTC (rev 352258)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 330543 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 352243 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.addfile">
<refnamediv>
<refname>Phar::addFile</refname>
@@ -86,6 +86,11 @@
</para>
</refsect1>
+ <refsect1 role="notes">
+ &reftitle.notes;
+ &phar.note.performance;
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
Modified: phpdoc/ja/trunk/reference/phar/Phar/addFromString.xml
===================================================================
--- phpdoc/ja/trunk/reference/phar/Phar/addFromString.xml 2020-12-28 21:27:03 UTC (rev 352257)
+++ phpdoc/ja/trunk/reference/phar/Phar/addFromString.xml 2020-12-28 21:37:33 UTC (rev 352258)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 334404 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 352243 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.addfromstring">
<refnamediv>
<refname>Phar::addFromString</refname>
@@ -81,6 +81,11 @@
</para>
</refsect1>
+ <refsect1 role="notes">
+ &reftitle.notes;
+ &phar.note.performance;
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
Modified: phpdoc/ja/trunk/reference/phar/Phar/offsetSet.xml
===================================================================
--- phpdoc/ja/trunk/reference/phar/Phar/offsetSet.xml 2020-12-28 21:27:03 UTC (rev 352257)
+++ phpdoc/ja/trunk/reference/phar/Phar/offsetSet.xml 2020-12-28 21:37:33 UTC (rev 352258)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 343887 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 352243 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.offsetset">
<refnamediv>
<refname>Phar::offsetSet</refname>
@@ -91,6 +91,11 @@
</para>
</refsect1>
+ <refsect1 role="notes">
+ &reftitle.notes;
+ &phar.note.performance;
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
Modified: phpdoc/ja/trunk/reference/phar/PharData/addFile.xml
===================================================================
--- phpdoc/ja/trunk/reference/phar/PharData/addFile.xml 2020-12-28 21:27:03 UTC (rev 352257)
+++ phpdoc/ja/trunk/reference/phar/PharData/addFile.xml 2020-12-28 21:37:33 UTC (rev 352258)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 352109 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 352243 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="phardata.addfile">
<refnamediv>
<refname>PharData::addFile</refname>
@@ -85,6 +85,11 @@
</para>
</refsect1>
+ <refsect1 role="notes">
+ &reftitle.notes;
+ &phardata.note.performance;
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
Modified: phpdoc/ja/trunk/reference/phar/PharData/addFromString.xml
===================================================================
--- phpdoc/ja/trunk/reference/phar/PharData/addFromString.xml 2020-12-28 21:27:03 UTC (rev 352257)
+++ phpdoc/ja/trunk/reference/phar/PharData/addFromString.xml 2020-12-28 21:37:33 UTC (rev 352258)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 352107 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 352243 Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="phardata.addfromstring">
<refnamediv>
@@ -81,6 +81,11 @@
</para>
</refsect1>
+ <refsect1 role="notes">
+ &reftitle.notes;
+ &phardata.note.performance;
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
Modified: phpdoc/ja/trunk/reference/phar/PharData/offsetSet.xml
===================================================================
--- phpdoc/ja/trunk/reference/phar/PharData/offsetSet.xml 2020-12-28 21:27:03 UTC (rev 352257)
+++ phpdoc/ja/trunk/reference/phar/PharData/offsetSet.xml 2020-12-28 21:37:33 UTC (rev 352258)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 352107 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 352243 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="phardata.offsetset">
<refnamediv>
<refname>PharData::offsetSet</refname>
@@ -87,6 +87,11 @@
</para>
</refsect1>
+ <refsect1 role="notes">
+ &reftitle.notes;
+ &phardata.note.performance;
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>