cvs: phpdoc-ja /language/oop5 overloading.xml /reference/bbcode book.xml /reference/phar PharData.xml /reference/phar/Phar compress.xml
/reference/phar/PharData buildFromIterator.xml compressAllFilesBZIP2.xml compressAllFilesGZ.xml construct.xml convertToPhar.xml convertToTar.xml
convertToZip.xml copy.xml delMetadata.xml offsetSet.xml setAlias.xml setStub.xml
| From: | TAKAGI Masahiro | Date: | Fri, 28 Mar 2008 22:01:43 +0000 |
| Subject: | cvs: phpdoc-ja /language/oop5 overloading.xml /reference/bbcode book.xml /reference/phar PharData.xml /reference/phar/Phar compress.xml /reference/phar/PharData buildFromIterator.xml compressAllFilesBZIP2.xml compressAllFilesGZ.xml construct.xml convertToPhar.xml convertToTar.xml convertToZip.xml copy.xml delMetadata.xml offsetSet.xml setAlias.xml setStub.xml |
||
| Groups: | php.doc.ja | ||
| Request: | Send a blank email to doc-ja+get-2289@lists.php.net to get a copy of this message | ||
takagi Fri Mar 28 22:01:43 2008 UTC
Added files:
/phpdoc-ja/reference/phar/PharData setStub.xml setAlias.xml
offsetSet.xml delMetadata.xml
copy.xml convertToZip.xml
convertToTar.xml
convertToPhar.xml construct.xml
compressAllFilesGZ.xml
compressAllFilesBZIP2.xml
buildFromIterator.xml
/phpdoc-ja/reference/phar/Phar compress.xml
/phpdoc-ja/reference/phar PharData.xml
Modified files:
/phpdoc-ja/reference/bbcode book.xml
/phpdoc-ja/language/oop5 overloading.xml
Log:
sync with en.
http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/bbcode/book.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-ja/reference/bbcode/book.xml diff -u phpdoc-ja/reference/bbcode/book.xml:1.3 phpdoc-ja/reference/bbcode/book.xml:1.4 --- phpdoc-ja/reference/bbcode/book.xml:1.3 Sat Dec 29 04:38:37 2007 +++ phpdoc-ja/reference/bbcode/book.xml Fri Mar 28 22:01:42 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.5 Maintainer: takagi Status: ready --> <!-- Membership: external, pecl --> <book xml:id="book.bbcode" xmlns="http://docbook.org/ns/docbook"> @@ -26,6 +26,7 @@ &reference.bbcode.setup; &reference.bbcode.constants; + &reference.bbcode.reference; </book> http://cvs.php.net/viewvc.cgi/phpdoc-ja/language/oop5/overloading.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-ja/language/oop5/overloading.xml diff -u phpdoc-ja/language/oop5/overloading.xml:1.14 phpdoc-ja/language/oop5/overloading.xml:1.15 --- phpdoc-ja/language/oop5/overloading.xml:1.14 Sat Mar 1 05:55:22 2008 +++ phpdoc-ja/language/oop5/overloading.xml Fri Mar 28 22:01:42 2008 @@ -1,34 +1,93 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.25 Maintainer: hirokawa Status: ready --> -<!-- CREDITS: shimooka --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.27 Maintainer: takagi Status: ready --> +<!-- CREDITS: hirokawa,shimooka --> <sect1 xml:id="language.oop5.overloading" xmlns="http://docbook.org/ns/docbook"> <title>ãªã¼ãã¼ãã¼ã</title> <para> - ã¡ã½ããå¼ã³åºãã¨ã¡ã³ãã¼ã¸ã®ã¢ã¯ã»ã¹ã®ãããã«ã¤ãã¦ãã - __call, __get ãã㦠__set ã¡ã½ãããéãã¦ãªã¼ãã¼ãã¼ããããã¨ãã§ãã¾ãã - ãªãã¸ã§ã¯ããç¶æ¿ããããªãã¸ã§ã¯ãã - ã¢ã¯ã»ã¹ãããã¨ãã¦ãã <modifier>public</modifier> - ã¡ã³ãã¼ãããã¯ã¡ã½ãããå«ãã§ããªãå ´åã§ãã - ãããã®ã¡ã½ããã¯å®è¡ããã¾ãã - ãªã¼ãã¼ãã¼ããã¦ããå ¨ã¦ã®ã¡ã½ãã㯠- <link linkend="language.oop5.visibility">public</link> - ã¨ãã¦å®ç¾©ããã¦ããªããã°ãªãã¾ããã + PHP ã«ããããªã¼ãã¼ãã¼ãæ©è½ã¯ã + ã¡ã³ãã¼ãã¡ã½ãããåçã« + <quote>ä½æãã</quote> ããã®ææ³ã§ãã + ãããã®åçã¨ã³ãã£ãã£ã¯ããã¸ãã¯ã¡ã½ãããç¨ãã¦å¦çããã¾ãã + ãã¸ãã¯ã¡ã½ããã¯ãã¯ã©ã¹å ã§ãã¾ãã¾ãªã¢ã¯ã·ã§ã³ã«å¯¾ãã¦ç¨æãããã¨ãã§ãã¾ãã </para> + <para> - PHP 5.1.0 以éã__isset ã __unset ã¡ã½ãããéã㦠- <function>isset</function> é¢æ°ã <function>unset</function> - é¢æ°ãåã ã«ãªã¼ãã¼ãã¼ãããäºãå¯è½ã§ãã - ã¡ã½ãã __isset ã¯ã<function>empty</function> ã§ãã³ã¼ã«ããã¾ãã + ãªã¼ãã¼ãã¼ãã¡ã½ãããèµ·åããã®ã¯ã + 宣è¨ããã¦ããªãã¡ã³ãã¼ãã¡ã½ãããæä½ãããã¨ããã¨ãã§ãã + ã¾ããç¾å¨ã®ã¹ã³ã¼ããã㯠+ <link linkend="language.oop5.visibility">ã¢ã¯ã»ã¹ä¸è½ãª</link> + ã¡ã³ãã¼ãã¡ã½ãããæä½ãããã¨ããã¨ãã«ãèµ·åãã¾ãã + ãã®ã»ã¯ã·ã§ã³ã§ã¯ããããã® (宣è¨ããã¦ããªãã + ãããã¯ç¾å¨ã®ã¹ã³ã¼ãããã¯ã¢ã¯ã»ã¹ä¸è½ãª) ã¡ã³ãã¼ãã¡ã½ããã®ãã¨ã + <quote>ã¢ã¯ã»ã¹ä¸è½ã¡ã³ãã¼</quote> ããã³ + <quote>ã¢ã¯ã»ã¹ä¸è½ã¡ã½ãã</quote> + ã¨è¡¨è¨ãããã¨ã«ãã¾ãã </para> + <para> - PHP 5.3.0 ã§ã¯ã - <link linkend="language.oop5.static">static</link> - ã¡ã½ããã®ãªã¼ãã¼ãã¼ãã __callStatic ã§ã§ããããã«ãªãã¾ããã +<!-- +Test scripts indicate otherwise. +Will communicate with internals to see what's up. +http://bugs.php.net/bug.php?id=43924 +--> + ãªã¼ãã¼ãã¼ãã¡ã½ããã¯ããã¹ã¦ <literal>public</literal> + ã§å®ç¾©ããªããã°ãªãã¾ããã </para> + <note> + <para> + ãããã®ãã¸ãã¯ã¡ã½ããã®å¼æ°ã¯ã + <link linkend="functions.arguments.by-reference">åç §æ¸¡ã</link> + ã¨ãããã¨ã¯ã§ãã¾ããã + </para> + </note> + + <note> + <para> + PHP ã«ããã <quote>ãªã¼ãã¼ãã¼ã</quote> + ã®è§£éã¯ãä»ã®å¤ãã®ãªãã¸ã§ã¯ãæåè¨èªã¨ã¯ç°ãªãã¾ãã + ä¸è¬çã«ããªã¼ãã¼ãã¼ããã¨ã¯ã + ãååã¯åãã ããã©ãå¼æ°ã®æ°ãåãç°ãªãã¡ã½ãããè¤æ°ç¨æã§ããã + ã¨ããæ©è½ã®ãã¨ãæãã¾ãã + </para> + </note> + + + <sect2 xml:id="language.oop5.overloading.changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.1.0</entry> + <entry> + <literal>__isset()</literal> 㨠<literal>__unset()</literal> + ã追å ããã¾ããã + </entry> + </row> + <row> + <entry>5.3.0</entry> + <entry> + <literal>__callStatic()</literal> ã追å ããã¾ããã + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </sect2> + + <sect2 xml:id="language.oop5.overloading.members"> <title>ã¡ã³ãã¼ã®ãªã¼ãã¼ãã¼ã</title> @@ -51,121 +110,134 @@ </methodsynopsis> <para> - ç¬èªã®ã¯ã©ã¹ã§å®ç¾©ããã¦ããã«ã¹ã¿ã ã³ã¼ããå®è¡ããããã«ã - ç¹å¥ãªååãæã¤ã¡ã½ããã«ãã£ã¦ã¯ã©ã¹ã¡ã³ãã¼ããªã¼ãã¼ãã¼ã - ãããã¨ãã§ãã¾ãã - 使ç¨ããã <varname>$name</varname> ãã©ã¡ã¼ã¿ã¯ã - è¨å®ãããã¯åå¾ãããå¤æ°åã§ãã - __set() ã¡ã½ããã® <varname>$value</varname> ãã©ã¡ã¼ã¿ã«ãã - ãªãã¸ã§ã¯ãã <varname>$name</varname> ã«è¨å®ããå¤ãæå®ãã¾ãã + <literal>__set()</literal> ã¯ã + ã¢ã¯ã»ã¹ä¸è½ã¡ã³ãã¼ã¸ãã¼ã¿ãæ¸ãè¾¼ãéã«å®è¡ããã¾ãã + </para> + + <para> + <literal>__get()</literal> ã¯ã + ã¢ã¯ã»ã¹ä¸è½ã¡ã³ãã¼ãããã¼ã¿ãèªã¿è¾¼ãéã«ä½¿ç¨ãã¾ãã </para> - <note> - <para> - <literal>__set()</literal> ã¡ã½ããã§ã¯ãå¼æ°ãåç §æ¸¡ãã§åãåããã¨ã¯ã§ãã¾ããã - </para> - </note> + <para> + <literal>__isset()</literal> ã¯ã + <function>isset</function> ããã㯠<function>empty</function> + ãã¢ã¯ã»ã¹ä¸è½ã¡ã³ãã¼ã«å¯¾ãã¦å®è¡ããã¨ãã«èµ·åãã¾ãã + </para> + + <para> + <literal>__unset()</literal> ã¯ã + <function>unset</function> + ãã¢ã¯ã»ã¹ä¸è½ã¡ã³ãã¼ã«å¯¾ãã¦å®è¡ããã¨ãã«èµ·åãã¾ãã + </para> + + <para> + å¼æ° <varname>$name</varname> ã¯ã + æä½ãããã¨ããã¡ã³ãã¼ã®ååã§ãã + <literal>__set()</literal> ã¡ã½ããã®å¼æ° + <varname>$value</varname> ã¯ã + <varname>$name</varname> ã«è¨å®ãããã¨ããå¤ã¨ãªãã¾ãã + </para> + + <para> + ã¡ã³ãã¼ã®ãªã¼ãã¼ãã¼ãã¯ãªãã¸ã§ã¯ãã®ã³ã³ããã¹ãã§ã®ã¿åä½ãã¾ãã + ãããã®ãã¸ãã¯ã¡ã½ããã¯ãéçã³ã³ããã¹ãã§ã¯èµ·åãã¾ããã + ãããã£ã¦ããããã®ã¡ã½ãã㯠+ <link linkend="language.oop5.static">static</link> + 宣è¨ãããã¨ã¯ã§ãã¾ããã + </para> <example> <title>__get, __set, __isset, __unset ã使ã£ããªã¼ãã¼ãã¼ãã®ä¾</title> <programlisting role="php"> <![CDATA[ <?php -class Setter -{ - public $n; - private $x = array("a" => 1, "b" => 2, "c" => 3); - - public function __get($nm) - { - echo "Getting [$nm]\n"; - - if (isset($this->x[$nm])) { - $r = $this->x[$nm]; - print "Returning: $r\n"; - return $r; - } else { - echo "Nothing!\n"; - } +class MemberTest { + /** ãªã¼ãã¼ãã¼ãããããã¼ã¿ã®å ´æ */ + private $data = array(); + + /** 宣è¨ããã¦ããã¡ã³ãã¼ã«ã¯ãªã¼ãã¼ãã¼ãã¯èµ·åãã¾ãã */ + public $declared = 1; + + /** ã¯ã©ã¹å ããã¢ã¯ã»ã¹ããå ´åã«ã¯ãªã¼ãã¼ãã¼ãã¯èµ·åãã¾ãã */ + private $hidden = 2; + + public function __set($name, $value) { + echo "Setting '$name' to '$value'\n"; + $this->data[$name] = $value; } - public function __set($nm, $val) - { - echo "Setting [$nm] to $val\n"; - - if (isset($this->x[$nm])) { - $this->x[$nm] = $val; - echo "OK!\n"; - } else { - echo "Not OK!\n"; + public function __get($name) { + echo "Getting '$name'\n"; + if (array_key_exists($name, $this->data)) { + return $this->data[$name]; } - } - public function __isset($nm) - { - echo "Checking if $nm is set\n"; + $trace = debug_backtrace(); + trigger_error( + 'Undefined property: ' . $name . + ' in ' . $trace[0]['file'] . + ' on line ' . $trace[0]['line'], + E_USER_NOTICE); + $tmp = null; + return $tmp; + } - return isset($this->x[$nm]); + /** PHP 5.1.0 以é */ + public function __isset($name) { + echo "Is '$name' set?\n"; + return isset($this->data[$name]); } - public function __unset($nm) - { - echo "Unsetting $nm\n"; + /** PHP 5.1.0 以é */ + public function __unset($name) { + echo "Unsetting '$name'\n"; + unset($this->data[$name]); + } - unset($this->x[$nm]); + /** ãã¸ãã¯ã¡ã½ããã§ã¯ããã¾ãããåãªãä¾ã¨ãã¦ç¤ºãã¦ãã¾ã */ + public function getHidden() { + echo "'hidden' visible here so __get() not used\n"; + return $this->hidden; } } -$foo = new Setter(); -$foo->n = 1; -$foo->a = 100; -$foo->a++; -$foo->z++; - -var_dump(isset($foo->a)); //true -unset($foo->a); -var_dump(isset($foo->a)); //false - -// this doesn't pass through the __isset() method -// because 'n' is a public property -var_dump(isset($foo->n)); -var_dump($foo); +echo "<pre>\n"; + +$obj = new MemberTest; + +$obj->a = 1; +echo $obj->a . "\n"; + +var_dump(isset($obj->a)); +unset($obj->a); +var_dump(isset($obj->a)); + +echo $obj->declared . "\n"; +echo $obj->getHidden() . "\n"; +echo $obj->hidden . "\n"; ?> ]]> </programlisting> &example.outputs; <screen role="php"> <![CDATA[ -Setting [a] to 100 -OK! -Getting [a] -Returning: 100 -Setting [a] to 101 -OK! -Getting [z] -Nothing! -Setting [z] to 1 -Not OK! - -Checking if a is set +Setting 'a' to '1' +Getting 'a' +1 +Is 'a' set? bool(true) -Unsetting a -Checking if a is set +Unsetting 'a' +Is 'a' set? bool(false) -bool(true) +1 +'hidden' visible here so __get() not used +2 +Getting 'hidden' -object(Setter)#1 (2) { - ["n"]=> - int(1) - ["x":"Setter":private]=> - array(2) { - ["b"]=> - int(2) - ["c"]=> - int(3) - } -} + +Notice: Undefined property: hidden in <file> on line 64 in <file> on line 28 ]]> </screen> @@ -187,100 +259,53 @@ </methodsynopsis> <para> - ç¹å¥ãªã¡ã½ãã __call() ããã³ __callStatic() ã使ç¨ããã¨ã - åå¨ããªãã¡ã½ããã®å¼ã³åºããææãããã¨ãã§ãã¾ãã - ãããã®ã¡ã½ããã使ç¨ããã¨ãå®éã«ã³ã¼ã«ãããã¡ã½ããã®ååã«å¿ãã - ã¦ã¼ã¶å®ç¾©ã®å¦çãå®è£ ãããã¨ãã§ãã¾ãã - ããã¯ããã¨ãã°ãããã·ãå®è£ ããå ´åãªã©ã«ä¾¿å©ã§ãã - é¢æ°ã«æ¸¡ãããå¼æ°ã¯ãã©ã¡ã¼ã¿ - <varname>$arguments</varname> ã§åãåããã¨ãã§ãã - ãããã®ã¡ã½ããã®è¿ãå¤ãå¼ã³åºãå ã®ã¡ã½ããã®è¿ãå¤ã¨ãªãã¾ãã + <literal>__call()</literal> ã¯ã + ã¢ã¯ã»ã¹ä¸è½ã¡ã½ããããªãã¸ã§ã¯ãã®ã³ã³ããã¹ãã§å®è¡ããã¨ãã«èµ·åãã¾ãã </para> + <para> + <literal>__callStatic()</literal> ã¯ã + ã¢ã¯ã»ã¹ä¸è½ã¡ã½ãããéçã³ã³ããã¹ãã§å®è¡ããã¨ãã«èµ·åãã¾ãã + </para> + + <para> + å¼æ° <varname>$name</varname> ã¯ã + ã³ã¼ã«ãããã¨ããã¡ã½ããã®ååã§ãã + å¼æ° <varname>$arguments</varname> + ã¯é åã§ãã¡ã½ãã <varname>$name</varname> + ã«æ¸¡ããã¨ãããã©ã¡ã¼ã¿ãæ ¼ç´ããã¾ãã + </para> <example> - <title>__call ã«ãããã¤ã³ã¹ã¿ã³ã¹åãããã¡ã½ããã®ãªã¼ãã¼ãã¼ãã®ä¾</title> + <title>__call ããã³ ___callStatic ã«ãããã¤ã³ã¹ã¿ã³ã¹åãããã¡ã½ããã®ãªã¼ãã¼ãã¼ãã®ä¾</title> <programlisting role="php"> <![CDATA[ <?php -class Caller -{ - private $x = array(10, 20); - - public function __call($m, $a) - { - print "Instantiated method '$m' called:\n"; - var_dump($a); - return $this->x; +class MethodTest { + public function __call($name, $arguments) { + echo "Calling object method '$name' " + . implode(', ', $arguments). "\n"; } -} - -$foo = new Caller(); -$a = $foo->test('a', 'b'); -var_dump($a); -?> -]]> - </programlisting> - &example.outputs; - <screen role="php"> -<![CDATA[ - -Instantiated method 'test' called: -array(2) { - [0]=> - string(1) "a" - [1]=> - string(1) "b" -} -array(2) { - [0]=> - int(10) - [1]=> - int(20) -} -]]> - </screen> - </example> - <example> - <title>__call ã«ãããã¤ã³ã¹ã¿ã³ã¹åãããã¡ã½ããã®ãªã¼ãã¼ãã¼ãã®ä¾</title> - <programlisting role="php"> - <![CDATA[ -<?php -class Caller -{ - private static $x = array(10, 20); - - public static function __callStatic($m, $a) - { - print "Static method '$m' called:\n"; - var_dump($a); - return self::$x; + /** PHP 5.3.0 以é */ + public static function __callStatic($name, $arguments) { + echo "Calling static method '$name' " + . implode(', ', $arguments). "\n"; } } -$a = Caller::test('a', 'b'); -var_dump($a); +$obj = new MethodTest; +$obj->test('in object context'); + +MethodTest::test('in static context'); // PHP 5.3.0 以é ?> ]]> </programlisting> &example.outputs; <screen role="php"> <![CDATA[ - -Static method 'test' called: -array(2) { - [0]=> - string(1) "a" - [1]=> - string(1) "b" -} -array(2) { - [0]=> - int(10) - [1]=> - int(20) -} +Calling object method 'test' in object context +Calling static method 'test' in static context ]]> </screen> </example> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/setStub.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/setStub.xml +++ phpdoc-ja/reference/phar/PharData/setStub.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phardata.setstub"> <refnamediv> <refname>PharData::setStub</refname> <refpurpose>ããã¼é¢æ° (Phar::setStub 㯠PharData ã§ã¯ä½¿ç¨ä¸è½)</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>PharData::setStub</methodname> <methodparam><type>string</type><parameter>stub</parameter></methodparam> </methodsynopsis> <para> å®è¡å¯è½ã§ãªã tar/zip ã¢ã¼ã«ã¤ãã¯ã¹ã¿ããæã¤ãã¨ãã§ããªãã®ã§ã ãã®ã¡ã½ããã¯åã«ä¾å¤ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>stub</parameter></term> <listitem> <para> æååãããã¯ãªã¼ãã³ããã¹ããªã¼ã ãã³ãã«ã ãã® phar ã¢ã¼ã«ã¤ãã®å®è¡ã¹ã¿ãã¨ãã¦ä½¿ç¨ãã¾ãã ãã®ãã©ã¡ã¼ã¿ã¯ç¡è¦ããã¾ãã </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> ãã®ã¡ã½ãããã³ã¼ã«ãããã¨å¿ ã <classname>PharException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::setStub</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/setAlias.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/setAlias.xml +++ phpdoc-ja/reference/phar/PharData/setAlias.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xml:id="phardata.setalias" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::setAlias</refname> <refpurpose>ããã¼é¢æ° (Phar::setAlias 㯠PharData ã§ã¯ä½¿ç¨ä¸è½)</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::setAlias</methodname> <methodparam><type>string</type><parameter>alias</parameter></methodparam> </methodsynopsis> <para> å®è¡å¯è½ã§ãªã tar/zip ã¢ã¼ã«ã¤ãã¯ã¨ã¤ãªã¢ã¹ãæã¤ãã¨ãã§ããªãã®ã§ã ãã®ã¡ã½ããã¯åã«ä¾å¤ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>alias</parameter></term> <listitem> <para> ãã®ã¢ã¼ã«ã¤ããæãã¨ãã«ä½¿ç¨ããçãæååã <literal>phar</literal> ã¹ããªã¼ã ã©ããã¼ãã¢ã¯ã»ã¹ããéã«ããã使ç¨ãã¾ãã ãã®ãã©ã¡ã¼ã¿ã¯ç¡è¦ããã¾ãã </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> ãã®ã¡ã½ãããã³ã¼ã«ãããã¨å¿ ã <classname>PharException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::setAlias</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/offsetSet.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/offsetSet.xml +++ phpdoc-ja/reference/phar/PharData/offsetSet.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phardata.offsetset"> <refnamediv> <refname>PharData::offsetSet</refname> <refpurpose>tar/zip ã®å é¨ã®ãã¡ã¤ã«ã«ãå¤é¨ãã¡ã¤ã«ãããã¯æååã®å 容ãè¨å®ãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>PharData::offsetSet</methodname> <methodparam><type>string</type><parameter>offset</parameter></methodparam> <methodparam><type>string</type><parameter>value</parameter></methodparam> </methodsynopsis> <para> ãã㯠<interfacename>ArrayAccess</interfacename> ã¤ã³ã¿ã¼ãã§ã¤ã¹ãå®è£ ãããã®ã§ãã ããã«ãããtar/zip ã¢ã¼ã«ã¤ãã®å 容ã«å¯¾ãã¦é åå½¢å¼ã®è§æ¬å¼§ã使ç¨ããã¢ã¯ã»ã¹ãå¯è½ã¨ãªãã¾ãã offsetSet ã使ç¨ãã¦ãtar/zip ã¢ã¼ã«ã¤ãã®æ¢åãã¡ã¤ã«ã®å¤æ´ã æ°ãããã¡ã¤ã«ã®è¿½å ãè¡ãã¾ãã </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>offset</parameter></term> <listitem> <para> tar ããã㯠zip ã¢ã¼ã«ã¤ãå ã§å¤æ´ãããã¡ã¤ã«å (ç¸å¯¾ãã¹)ã </para> </listitem> </varlistentry> <varlistentry> <term><parameter>value</parameter></term> <listitem> <para> ãã¡ã¤ã«ã®å 容ã </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> å¤ãè¿ãã¾ããã </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Phar ã¢ã¼ã«ã¤ãã¸ã®å¤æ´ããã£ã¹ã¯ã«æ¸ãè¾¼ãéã«ä½ããã®ã¨ã©ã¼ãçºçãã㨠<classname>PharException</classname> ãã¹ãã¼ããã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>PharData::offsetSet</function> ã®ä¾</title> <para> offsetSet ã¯ç´æ¥ä½¿ç¨ãã¦ã¯ããã¾ããã é åã« <literal>[]</literal> æ¼ç®åã§ã¢ã¯ã»ã¹ããéã«ä½¿ç¨ããã¾ãã </para> <programlisting role="php"> <![CDATA[ <?php $p = new PharData('/path/to/my.tar'); try { // offsetSet ãã³ã¼ã«ããã¾ã $p['file.txt'] = 'Hi there'; } catch (Exception $e) { echo 'file.txt ãå¤æ´ã§ãã¾ãã: ', $e; } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::offsetSet</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/delMetadata.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/delMetadata.xml +++ phpdoc-ja/reference/phar/PharData/delMetadata.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xml:id="phardata.delmetadata" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::delMetadata</refname> <refpurpose>zip ã¢ã¼ã«ã¤ãã®ã°ãã¼ãã«ã¡ã¿ãã¼ã¿ãåé¤ãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>PharData::delMetadata</methodname> <void/> </methodsynopsis> &phar.write; <para> zip ã¢ã¼ã«ã¤ãã®ã°ãã¼ãã«ã¡ã¿ãã¼ã¿ãåé¤ãã¾ãã </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> æåããå ´åã« &true; ãè¿ãã¾ããããããããå®å ¨ãæããªã ä¾å¤ãã¹ãã¼ãããªããã¨ã確èªããã¨ããã§ãããã </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> å¤æ´ããã£ã¹ã¯ã«æ¸ãæ»ãéã«ã¨ã©ã¼ãçºçããå ´å㯠<classname>PharException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>PharData::delMetaData</function> ã®ä¾</title> <programlisting role="php"> <![CDATA[ <?php try { $phar = new PharData('myphar.zip'); var_dump($phar->getMetadata()); $phar->setMetadata("hi there"); var_dump($phar->getMetadata()); $phar->delMetadata(); var_dump($phar->getMetadata()); } catch (Exception $e) { // ã¨ã©ã¼å¦ç } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ NULL string(8) "hi there" NULL ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::delMetadata</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/copy.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/copy.xml +++ phpdoc-ja/reference/phar/PharData/copy.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xml:id="phardata.copy" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::copy</refname> <refpurpose>phar ã¢ã¼ã«ã¤ãå ã®ãã¡ã¤ã«ããphar å ã§å¥ã®æ°ãããã¡ã¤ã«ã¨ãã¦ã³ãã¼ãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::copy</methodname> <methodparam><type>string</type><parameter>oldfile</parameter></methodparam> <methodparam><type>string</type><parameter>newfile</parameter></methodparam> </methodsynopsis> <para> phar ã¢ã¼ã«ã¤ãå ã®ãã¡ã¤ã«ãããã®ã¢ã¼ã«ã¤ãå ã§å¥ã®æ°ãããã¡ã¤ã«ã¨ãã¦ã³ãã¼ãã¾ãã ããã¯ãphar ã¹ããªã¼ã ã©ããã¼ã§ã® <function>copy</function> ã¨åçã®æä½ããªãã¸ã§ã¯ãæåã§è¡ããã®ã§ãã </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>oldfile</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>newfile</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> æåããå ´åã« &true; ãè¿ãã¾ããããããããå®å ¨ãæããªã try/catch ãããã¯å ã§ä½¿ç¨ãã¦ä¾å¤ãã¹ãã¼ãããªããã¨ã確èªããã¨ããã§ãããã </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> ã³ãã¼å ã®ãã¡ã¤ã«ãåå¨ããªããã³ãã¼å ã®ãã¡ã¤ã«ãæ¢ã«åå¨ããã æ¸ãè¾¼ã¿ã¢ã¯ã»ã¹ãç¡å¹ã«ãªã£ã¦ãããã©ã¡ããã®ãã¡ã¤ã«ã®ãªã¼ãã³ã«å¤±æããã ãããã¯ã³ãã¼å ã®ãã¡ã¤ã«ã®èªã¿è¾¼ã¿ã«å¤±æããå ´åã« <classname>UnexpectedValueException</classname> ãã¹ãã¼ãã¾ãã å¤æ´å 容㮠phar ã¸ã®æ¸ãè¾¼ã¿ã«å¤±æããå ´å㯠<classname>PharException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>PharData::copy</function> ã®ä¾</title> <para> ãã®ä¾ã¯ã<function>PharData::copy</function> ã®ä½¿ç¨æ³ã®ã»ãã« ããã¨åçã®æä½ãã¹ããªã¼ã ã©ããã¼ã§è¡ãæ¹æ³ã示ããã®ã§ãã ãããã®æ¹å¼ã®æ大ã®éãã¯ã¨ã©ã¼å¦çã§ãã PharData ã®ãã¹ã¦ã®ã¡ã½ããã¯ä¾å¤ãã¹ãã¼ãã¾ãããã¹ããªã¼ã ã©ããã¼ã®å ´å㯠<function>trigger_error</function> ã使ç¨ãã¾ãã </para> <programlisting role="php"> <![CDATA[ <?php try { $phar = new PharData('myphar.tar'); $phar['a'] = 'hi'; $phar->copy('a', 'b'); echo $phar['b']; // åºå㯠"hi" } catch (Exception $e) { // ã¨ã©ã¼å¦ç } // ä¸ã®ã³ã¼ãã¨åçã®å¦çãã¹ããªã¼ã ã©ããã¼ã§è¡ãä¾ã // ã¨ã©ã¼æã«ã¯ä¾å¤ã§ã¯ãªã E_WARNINGS ãçºçãã¾ã copy('phar://myphar.tar/a', 'phar//myphar.tar/c'); echo file_get_contents('phar://myphar.tar/c'); // åºå㯠"hi" ?> ]]> </programlisting> </example> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/convertToZip.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/convertToZip.xml +++ phpdoc-ja/reference/phar/PharData/convertToZip.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xml:id="phardata.converttozip" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::convertToZip</refname> <refpurpose>tar ã¢ã¼ã«ã¤ãã zip ãã¡ã¤ã«å½¢å¼ã«å¤æãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::convertToZip</methodname> <methodparam><type>string</type><parameter>extension</parameter></methodparam> </methodsynopsis> <para> ãã®ã¡ã½ããã¯ãphar å½¢å¼ããã㯠tar å½¢å¼ã® phar ã¢ã¼ã«ã¤ãã zip ãã¡ã¤ã«å½¢å¼ã«å¤æãã¾ãã </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>extension</parameter></term> <listitem> <para> ããã©ã«ãã§ã¯ãtar ã¢ã¼ã«ã¤ãããå¤æããéã®æ¡å¼µå㯠<literal>.zip</literal> ã¨ãªãã¾ãã </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> ãã®ã¡ã½ããã¯ãæåããå ´åã« <classname>PharData</classname> ãªãã¸ã§ã¯ããè¿ãã¾ãã 失æããå ´åã«ã¯ä¾å¤ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> å§ç¸®ãã§ããªãå ´åãç¡å¹ãªå§ç¸®æ¹å¼ãæå®ãããå ´åãããã㯠<function>Phar::startBuffering</function> ã§ãããã¡ãªã³ã°ããã¾ã¾ <function>Phar::stopBuffering</function> ãå®è¡ãã¦ããªãã¢ã¼ã«ã¤ããå¦çãããã¨ããå ´åã« <classname>BadMethodCallException</classname> ãã¹ãã¼ãã¾ãã ã¾ããæ¸ãè¾¼ã¿ãµãã¼ããç¡å¹ãªå ´åã« <classname>UnexpectedValueException</classname>ã zip ä½æä¸ã«ä½ããã®åé¡ãçºçããå ´åã« <classname>PharException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>PharData::convertToZip</function> ã®ä¾</title> <para> PharData::convertToZip() ã®ä½¿ç¨æ³ã§ãã </para> <programlisting role="php"> <![CDATA[ <?php try { $tar = new PharData('myphar.tar.gz'); // zip ãã¡ã¤ã«å½¢å¼ã«å¤æãã¾ã $zip = $tar->convertToZip(); } catch (Exception $e) { // ããã§ã¨ã©ã¼å¦çããã¾ã } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::convertToZip</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/convertToTar.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/convertToTar.xml +++ phpdoc-ja/reference/phar/PharData/convertToTar.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xml:id="phardata.converttotar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::convertToTar</refname> <refpurpose>zip ã¢ã¼ã«ã¤ãã tar ãã¡ã¤ã«å½¢å¼ã«å¤æãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::convertToTar</methodname> <methodparam><type>string</type><parameter>extension</parameter></methodparam> </methodsynopsis> <para> ãã®ã¡ã½ããã¯ãphar å½¢å¼ããã㯠zip å½¢å¼ã® phar ã¢ã¼ã«ã¤ãã tar ãã¡ã¤ã«å½¢å¼ã«å¤æãã¾ãã </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>extension</parameter></term> <listitem> <para> ããã©ã«ãã§ã¯ãzip ã¢ã¼ã«ã¤ãããå¤æããéã®æ¡å¼µå㯠<literal>.tar</literal> ã¨ãªãã¾ãã </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> ãã®ã¡ã½ããã¯ãæåããå ´åã« <classname>PharData</classname> ãªãã¸ã§ã¯ããè¿ãã¾ãã 失æããå ´åã«ã¯ä¾å¤ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> å§ç¸®ãã§ããªãå ´åãç¡å¹ãªå§ç¸®æ¹å¼ãæå®ãããå ´åãããã㯠<function>Phar::startBuffering</function> ã§ãããã¡ãªã³ã°ããã¾ã¾ <function>Phar::stopBuffering</function> ãå®è¡ãã¦ããªãã¢ã¼ã«ã¤ããå¦çãããã¨ããå ´åã« <classname>BadMethodCallException</classname> ãã¹ãã¼ãã¾ãã ã¾ããæ¸ãè¾¼ã¿ãµãã¼ããç¡å¹ãªå ´åã« <classname>UnexpectedValueException</classname>ã tar ä½æä¸ã«ä½ããã®åé¡ãçºçããå ´åã« <classname>PharException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>PharData::convertToTar</function> ã®ä¾</title> <para> PharData::convertToTar() ã®ä½¿ç¨æ³ã§ãã </para> <programlisting role="php"> <![CDATA[ <?php try { $zip = new PharData('myphar.zip'); $tar = $zip->convertToTar(); } catch (Exception $e) { // ããã§ã¨ã©ã¼å¦çããã¾ã } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::convertToTar</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/convertToPhar.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/convertToPhar.xml +++ phpdoc-ja/reference/phar/PharData/convertToPhar.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xml:id="phardata.converttophar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::convertToPhar</refname> <refpurpose>tar/zip ã¢ã¼ã«ã¤ãã phar ãã¡ã¤ã«å½¢å¼ã«å¤æãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::convertToPhar</methodname> <methodparam><type>string</type><parameter>extension</parameter></methodparam> </methodsynopsis> &phar.write; <para> ãã®ã¡ã½ããã¯ãtar/zip ã¢ã¼ã«ã¤ãã å®è¡å¯è½ãª phar ãã¡ã¤ã«å½¢å¼ã«å¤æãã¾ãã </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>extension</parameter></term> <listitem> <para> ããã©ã«ãã®æ¡å¼µåã¯ãæªå§ç¸®ã® tar ã¢ã¼ã«ã¤ãããã㯠zip ã¢ã¼ã«ã¤ãããå¤æããå ´å㯠<literal>.phar</literal> ã¨ãªãã¾ããã¾ã zlib å§ç¸®ããã tar ã¢ã¼ã«ã¤ãããå¤æããå ´å㯠<literal>.phar.gz</literal>ãbzip2 å§ç¸®ããã tar ã¢ã¼ã«ã¤ãããå¤æããå ´å㯠<literal>.phar.bz2</literal> ã¨ãªãã¾ãã </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> ãã®ã¡ã½ããã¯ãæåããå ´åã« <classname>Phar</classname> ãªãã¸ã§ã¯ããè¿ãã¾ãã 失æããå ´åã«ã¯ä¾å¤ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> å§ç¸®ãã§ããªãå ´åãç¡å¹ãªå§ç¸®æ¹å¼ãæå®ãããå ´åãããã㯠<function>Phar::startBuffering</function> ã§ãããã¡ãªã³ã°ããã¾ã¾ <function>Phar::stopBuffering</function> ãå®è¡ãã¦ããªãã¢ã¼ã«ã¤ããå¦çãããã¨ããå ´åã« <classname>BadMethodCallException</classname> ãã¹ãã¼ãã¾ãã ã¾ããæ¸ãè¾¼ã¿ãµãã¼ããç¡å¹ãªå ´åã« <classname>UnexpectedValueException</classname>ã phar ä½æä¸ã«ä½ããã®åé¡ãçºçããå ´åã« <classname>PharException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>PharData::convertToPhar</function> ã®ä¾</title> <para> PharData::convertToPhar() ã®ä½¿ç¨æ³ã§ãã </para> <programlisting role="php"> <![CDATA[ <?php try { $tarphar = new PharData('myphar.tar'); // phar ãã©ã¼ãããã«å¤æãã¾ã // myphar.tar ã¯åé¤ããããªãããã¨ã«æ³¨æãã¾ããã $phar = $tarphar->convertToPhar(); // creates myphar.phar $phar->setStub($phar->createDefaultStub('cli.php', 'web/index.php')); } catch (Exception $e) { // ããã§ã¨ã©ã¼å¦çããã¾ã } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::convertToPhar</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/construct.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/construct.xml +++ phpdoc-ja/reference/phar/PharData/construct.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="phardata.construct"> <refnamediv> <refname>PharData::__construct</refname> <refpurpose>å®è¡å¯è½ã§ãªã tar ããã㯠zip ã¢ã¼ã«ã¤ããªãã¸ã§ã¯ããä½æãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>PharData::__construct</methodname> <methodparam><type>string</type><parameter>fname</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>fname</parameter></term> <listitem> <para> æ¢åã® tar/zip ã¢ã¼ã«ã¤ããããã¯ä½æãããã¢ã¼ã«ã¤ãã¸ã®ãã¹ã </para> </listitem> </varlistentry> <varlistentry> <term><parameter>flags</parameter></term> <listitem> <para> 親ã¯ã©ã¹ <classname>Phar</classname> ã® <classname>RecursiveDirectoryIterator</classname> ã«æ¸¡ããã©ã°ã <link xlink:href="http://www.php.net/~helly/php/ext/spl/classRecursiveDirectoryIterator.html#be0e1176d512c66500e5c26f248c89c4">SPL RecursiveDirectoryIterator ã®ããã¥ã¡ã³ã</link> ãåç §ãã ããã </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> 2 度ã³ã¼ã«ãããå ´åã« BadMethodCallExceptionã phar ã¢ã¼ã«ã¤ãã®ãªã¼ãã³ã«å¤±æããå ´åã« UnexpectedValueException ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>PharData::__construct</function> ã®ä¾</title> <para> <programlisting role="php"> <![CDATA[ <?php try { $p = new PharData('/path/to/my.tar', CURRENT_AS_FILEINFO | KEY_AS_FILENAME); } catch (UnexpectedValueException $e) { die('Could not open my.tar'); } catch (BadMethodCallException $e) { echo 'technically, this cannot happen'; } echo file_get_contents('phar:///path/to/my.tar/example.txt'); ?> ]]> </programlisting> </para> </example> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/compressAllFilesGZ.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/compressAllFilesGZ.xml +++ phpdoc-ja/reference/phar/PharData/compressAllFilesGZ.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phardata.compressallfilesgz"> <refnamediv> <refname>PharData::compressAllFilesGZ</refname> <refpurpose>ç¾å¨ã® tar/zip ã¢ã¼ã«ã¤ãå ã®ãã¹ã¦ã®ãã¡ã¤ã«ã Gzip ã§å§ç¸®ãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::compressAllFilesGZ</methodname> <void/> </methodsynopsis> <para> tar ã¢ã¼ã«ã¤ãã®å ´åããã®ã¡ã½ããã¯å¤±æã㦠<classname>PharException</classname> ã¨ãªãã¾ãã tar ãã©ã¼ãããã§åå¥ã®ãã¡ã¤ã«ãå§ç¸®ãããã¨ã¯ã§ããªãããã§ãã tar ã¢ã¼ã«ã¤ãå ¨ä½ãå§ç¸®ããã«ã¯ <function>PharData::compress</function> ã使ç¨ãã¾ãã </para> <para> zip ã¢ã¼ã«ã¤ãã®å ´åã¯ããã®ã¡ã½ãã㯠Phar ã¢ã¼ã«ã¤ãå ã®ãã¹ã¦ã®ãã¡ã¤ã«ã gzip ã§å§ç¸®ãã¾ãã ãã®æ©è½ã使ç¨ããã«ã¯ <link linkend="ref.zlib">zlib</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ãæå¹ã«ãªã£ã¦ããªããã°ãªãã¾ããã ã¾ãããã§ã« bzip2 ã§å§ç¸®ããã¦ãããã¡ã¤ã«ãå¦çããããã«ã¯ã ã¾ã bzip2 ã伸張ãã¦ãã gzip ã§åå§ç¸®ããããã <link linkend="ref.bzip2">bzip2</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ãæå¹ã«ãªã£ã¦ããªããã°ãªãã¾ããã </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> INI è¨å® <link linkend="ini.phar.readonly">phar.readonly</link> ã on ã®å ´åã<link linkend="ref.zlib">zlib</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ã使ç¨ã§ããªãå ´åãããã㯠bzip2 ã§å§ç¸®ããããã¡ã¤ã«ãããã®ã« <link linkend="ref.bzip2">bzip2</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ã使ç¨ã§ããªãå ´åã« <classname>BadMethodCallException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>PharData::compressAllFilesGZ</function> ã®ä¾</title> <programlisting role="php"> <![CDATA[ <?php $p = new PharData('/path/to/my.zip'); $p['myfile.txt'] = 'hi'; $p['myfile2.txt'] = 'hi'; foreach ($p as $file) { var_dump($file->getFileName()); var_dump($file->isCompressed()); var_dump($file->isCompressedBZIP2()); var_dump($file->isCompressedGZ()); } $p->compressAllFilesGZ(); foreach ($p as $file) { var_dump($file->getFileName()); var_dump($file->isCompressed()); var_dump($file->isCompressedBZIP2()); var_dump($file->isCompressedGZ()); } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ string(10) "myfile.txt" bool(false) bool(false) bool(false) string(11) "myfile2.txt" bool(false) bool(false) bool(false) string(10) "myfile.txt" bool(true) bool(false) bool(true) string(11) "myfile2.txt" bool(true) bool(false) bool(true) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::compressAllFilesGZ</function></member> <member><function>PharData::compress</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/compressAllFilesBZIP2.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/compressAllFilesBZIP2.xml +++ phpdoc-ja/reference/phar/PharData/compressAllFilesBZIP2.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phardata.compressallfilesbzip2"> <refnamediv> <refname>PharData::compressAllFilesBZIP2</refname> <refpurpose>ç¾å¨ã® tar/zip ã¢ã¼ã«ã¤ãå ã®ãã¹ã¦ã®ãã¡ã¤ã«ã Bzip2 ã§å§ç¸®ãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::compressAllFilesBZIP2</methodname> <void/> </methodsynopsis> <para> tar ã¢ã¼ã«ã¤ãã®å ´åããã®ã¡ã½ããã¯å¤±æã㦠<classname>PharException</classname> ã¨ãªãã¾ãã tar ãã©ã¼ãããã§åå¥ã®ãã¡ã¤ã«ãå§ç¸®ãããã¨ã¯ã§ããªãããã§ãã tar ã¢ã¼ã«ã¤ãå ¨ä½ãå§ç¸®ããã«ã¯ <function>PharData::compress</function> ã使ç¨ãã¾ãã </para> <para> ãã®ã¡ã½ããã¯ãzip ã¢ã¼ã«ã¤ãå ã®ãã¹ã¦ã®ãã¡ã¤ã«ã bzip2 ã§å§ç¸®ãã¾ãããã®æ©è½ã使ç¨ããã«ã¯ <link linkend="ref.bzip2">bzip2</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ãæå¹ã«ãªã£ã¦ããªããã°ãªãã¾ããã ã¾ãããã§ã« gzip ã§å§ç¸®ããã¦ãããã¡ã¤ã«ãå¦çããããã«ã¯ã ã¾ã gzip ã伸張ãã¦ãã bzip2 ã§åå§ç¸®ããããã <link linkend="ref.zlib">zlib</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ãæå¹ã«ãªã£ã¦ããªããã°ãªãã¾ããã </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> <link linkend="ref.bzip2">bzip2</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ã使ç¨ã§ããªãå ´åãããã㯠gzip ã§å§ç¸®ããããã¡ã¤ã«ãããã®ã« <link linkend="ref.zlib">zlib</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ã使ç¨ã§ããªãå ´åã« <classname>BadMethodCallException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>PharData::compressAllFilesBZIP2</function> ã®ä¾</title> <programlisting role="php"> <![CDATA[ <?php $p = new PharData('/path/to/my.zip'); $p['myfile.txt'] = 'hi'; $p['myfile2.txt'] = 'hi'; foreach ($p as $file) { var_dump($file->getFileName()); var_dump($file->isCompressed()); var_dump($file->isCompressedBZIP2()); var_dump($file->isCompressedGZ()); } $p->compressAllFilesBZIP2(); foreach ($p as $file) { var_dump($file->getFileName()); var_dump($file->isCompressed()); var_dump($file->isCompressedBZIP2()); var_dump($file->isCompressedGZ()); } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ string(10) "myfile.txt" bool(false) bool(false) bool(false) string(11) "myfile2.txt" bool(false) bool(false) bool(false) string(10) "myfile.txt" bool(true) bool(true) bool(false) string(11) "myfile2.txt" bool(true) bool(true) bool(false) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::compressAllFilesBZIP2</function></member> <member><function>PharData::compress</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/buildFromIterator.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/buildFromIterator.xml +++ phpdoc-ja/reference/phar/PharData/buildFromIterator.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xml:id="phardata.buildfromiterator" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::buildFromIterator</refname> <refpurpose>ã¤ãã¬ã¼ã¿ãã tar ããã㯠zip ã¢ã¼ã«ã¤ããä½æãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>PharData::buildFromIterator</methodname> <methodparam><type>Iterator</type><parameter>iter</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>base_directory</parameter></methodparam> </methodsynopsis> <para> tar ããã㯠zip ã¢ã¼ã«ã¤ããã¤ãã¬ã¼ã¿ããä½æãã¾ãã ãµãã¼ãããã¤ãã¬ã¼ã¿ã¯äºç¨®é¡ã§ã tar/zip å ã®ãã¡ã¤ã«åã¨ãã£ã¹ã¯ä¸ã®å®éã®ãã¡ã¤ã«åã対å¿ããããã®ããããã㯠DirectoryIterator ã®ããã« SplFileInfo ãªãã¸ã§ã¯ããè¿ããã®ã§ãã SplFileInfo ãªãã¸ã§ã¯ããè¿ãã¤ãã¬ã¼ã¿ã®å ´åã¯ã2 çªç®ã®ãã©ã¡ã¼ã¿ãå¿ è¦ã¨ãªãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>SplFileInfo ã使ç¨ãã <function>PharData::buildFromIterator</function> ã®ä¾</title> <para> ã»ã¨ãã©ã® tar/zip ã¢ã¼ã«ã¤ãã¯ãå®éã®ãã£ã¬ã¯ããªæ§é ãåæ ããå½¢å¼ã«ãªã£ã¦ãã¾ãã ãã®ãããªå ´å㯠2 çªç®ã®æ¹å¼ãæé©ã§ãã ãã¨ãã°ã次ã®ãããªãã£ã¬ã¯ããªæ§æã®ãã¡ã¤ã«ãå«ã tar/zip ã¢ã¼ã«ã¤ããä½æãã¦ã¿ããã¨ã«ãã¾ãããã </para> <para> <screen> <![CDATA[ /path/to/project/ config/ dist.xml debug.xml lib/ file1.php file2.php src/ processthing.php www/ index.php cli/ index.php ]]> </screen> </para> <para> 次ã®ã³ã¼ãã使ç¨ããã¨ããããã®ãã¡ã¤ã«ã tar ã¢ã¼ã«ã¤ã "project.tar" ã«è¿½å ãã¾ãã </para> <para> <programlisting role="php"> <![CDATA[ <?php $phar = new PharData('project.tar'); $phar->buildFromIterator( new RecursiveIteratorIterator( new RecursiveDirectoryIterator('/path/to/project')), '/path/to/project'); ?> ]]> </programlisting> </para> <para> ããã§ããã¡ã¤ã« <literal>project.tar</literal> ã¯ããã«ä½¿ããããã«ãªãã¾ãã <function>buildFromIterator</function> ã¯å§ç¸®ãã¡ã¿ãã¼ã¿ã®è¨å®ãè¡ãã¾ããã ããã㯠tar/zip ã¢ã¼ã«ã¤ããä½æããå¾ã§è¡ããã¨ãã§ãã¾ãã </para> <para> èå³æ·±ããã¨ã«ã<function>buildFromIterator</function> ã使ç¨ãã¦æ¢åã® phar ã tarãããã㯠zip ã¢ã¼ã«ã¤ãã®ä¸èº«ãã³ãã¼ãããã¨ãã§ãã¾ãã ã¨ããã®ã PharData ãªãã¸ã§ã¯ã㯠<classname>DirectoryIterator</classname> ãç¶æ¿ãã¦ããããã§ãã </para> <para> <programlisting role="php"> <![CDATA[ <?php $phar = new PharData('project.tar'); $phar->buildFromIterator( new RecursiveIteratorIterator( new Phar('/path/to/anotherphar.phar')), 'phar:///path/to/anotherphar.phar/path/to/project'); $phar->setStub($phar->createDefaultWebStub('cli/index.php', 'www/index.php')); ?> ]]> </programlisting> </para> </example> <example> <title>ãã®ä»ã®ã¤ãã¬ã¼ã¿ã使ç¨ãã <function>PharData::buildFromIterator</function> ã®ä¾</title> <para> ãã以å¤ã®å½¢å¼ã®ã¤ãã¬ã¼ã¿ã§ã¯ã key => value ã®å¯¾å¿ãè¿ããã®ã使ç¨ã§ãã¾ãããã¨ãã° <classname>ArrayIterator</classname> ãªã©ã§ãã </para> <para> <programlisting role="php"> <![CDATA[ <?php $phar = new PharData('project.tar'); $phar->buildFromIterator( new ArrayIterator( array( 'internal/file.php' => dirname(__FILE__) . '/somefile.php', 'another/file.jpg' => fopen('/path/to/bigfile.jpg', 'rb'), ))); ?> ]]> </programlisting> </para> </example> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>iter</parameter></term> <listitem> <para> phar ãã¡ã¤ã«ã¨å®éã®å ´æã®é¢é£ãè¿ãã¤ãã¬ã¼ã¿ã ããã㯠SplFileInfo ãªãã¸ã§ã¯ããè¿ãã¤ãã¬ã¼ã¿ã </para> </listitem> </varlistentry> <varlistentry> <term><parameter>base_directory</parameter></term> <listitem> <para> SplFileInfo ãªãã¸ã§ã¯ããè¿ãã¤ãã¬ã¼ã¿ãæå®ããéã tar/zip ã¢ã¼ã«ã¤ãã¸ã®è¿½å æã«ãã«ãã¹ããåãé¤ãé¨åã </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <function>buildFromIterator</function> ã¯é£æ³é åãè¿ãã¾ãã ããã¯ããã¡ã¤ã«ã®å é¨ãã¹ã¨ãã¡ã¤ã«ã·ã¹ãã ä¸ã®ãã«ãã¹ã対å¿ããããã®ã§ãã </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> ãã®ã¡ã½ããã¯ãã¤ãã¬ã¼ã¿ãééã£ãå¤ (ãã¨ãã°æååãã¼ã§ã¯ãªãæ´æ°ãã¼ãªã©) ãè¿ããå ´åã« <classname>UnexpectedValueException</classname> ãè¿ãã¾ããã¾ããSplFileInfo åã®ã¤ãã¬ã¼ã¿ã渡ããã¨ãã« <parameter>base_directory</parameter> ãæå®ããªãã£ãå ´å㯠<classname>BadMethodCallException</classname> ãã phar ã¢ã¼ã«ã¤ãã®ä¿åæã«ã¨ã©ã¼ãçºçããå ´å㯠<classname>PharException</classname> ãè¿ãã¾ãã </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::buildFromIterator</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/Phar/compress.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/Phar/compress.xml +++ phpdoc-ja/reference/phar/Phar/compress.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.compress"> <refnamediv> <refname>Phar::compress</refname> <refpurpose>Phar ã¢ã¼ã«ã¤ãå ¨ä½ã Gzip ããã㯠Bzip2 ã§å§ç¸®ãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>object</type><methodname>Phar::compress</methodname> <methodparam><type>int</type><parameter>compression</parameter></methodparam> </methodsynopsis> &phar.write; <para> tar å½¢å¼ããã㯠phar å½¢å¼ã® phar ã¢ã¼ã«ã¤ãã®å ´åã¯ã ãã®ã¡ã½ããã¯ã¢ã¼ã«ã¤ãå ¨ä½ã gzip ããã㯠bzip2 ã§å§ç¸®ãã¾ãã ã§ãããã£ããã¡ã¤ã«ã¯ gunzip/bunzip ã³ãã³ãã§å¦çãããã¨ãã§ãã¾ããã Phar æ¡å¼µã¢ã¸ã¥ã¼ã«ã§ç´æ¥ééçã«ä½¿ç¨ãããã¨ãã§ãã¾ãã </para> <para> zip å½¢å¼ã® phar ã¢ã¼ã«ã¤ãã®å ´åã¯ããã®ã¡ã½ããã¯å¤±æãã¦ä¾å¤ãçºçãã¾ãã gzip ã§å§ç¸®ããããã«ã¯ <link linkend="ref.zlib">zlib</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ãããã㦠bzip2 ã§å§ç¸®ããããã«ã¯ <link linkend="ref.bzip2">bzip2</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ãæå¹ã«ãªã£ã¦ããªããã°ãªãã¾ããã ãã®é¢æ°ã¯ phar ã®å 容ãå¤æ´ããã®ã§ã使ç¨ããã«ã¯ INI è¨å® <link linkend="ini.phar.readonly">phar.readonly</link> ã off ã«ãªã£ã¦ããªããã°ãªãã¾ããã </para> <para> ããã«ããã®ã¡ã½ããã¯èªåçã«ã¢ã¼ã«ã¤ãã®ååãå¤æ´ãã <literal>.gz</literal> ããã㯠<literal>.bz2</literal> ã追å ãã¾ãã<literal>Phar::NONE</literal> ã渡ãã¦å§ç¸®ã解é¤ããå ´åã¯æ¡å¼µåãåé¤ãã¾ãã </para> <para> <classname>Phar</classname> ãªãã¸ã§ã¯ããè¿ãã¾ãã </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>compression</parameter></term> <listitem> <para> å§ç¸®ãè¡ãå ´åã«ã¯ <literal>Phar::GZ</literal> ããã㯠<literal>Phar::BZ2</literal>ãå§ç¸®ã解é¤ããå ´åã«ã¯ <literal>Phar::NONE</literal> ãæå®ãã¾ãã </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> INI è¨å® <link linkend="ini.phar.readonly">phar.readonly</link> ã on ã®å ´åã<link linkend="ref.zlib">zlib</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ã使ç¨ã§ããªãå ´åãããã㯠<link linkend="ref.bzip2">bzip2</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ã使ç¨ã§ããªãå ´åã« <classname>BadMethodCallException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>Phar::compress</function> ã®ä¾</title> <programlisting role="php"> <![CDATA[ <?php $p = new Phar('/path/to/my.phar', 0, 'my.phar'); $p['myfile.txt'] = 'hi'; $p['myfile2.txt'] = 'hi'; $p1 = $p->compress(Phar::GZ); // /path/to/my.phar.gz ã«ã³ãã¼ãã¾ã $p2 = $p->compress(Phar::BZ2); // /path/to/my.phar.bz2 ã«ã³ãã¼ãã¾ã $p3 = $p2->compress(Phar::NONE); // ä¾å¤: /path/to/my.phar ã¯æ¢ã«åå¨ãã¾ã ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::getCompressedSize</function></member> <member><function>PharFileInfo::isCompressedBZIP2</function></member> <member><function>PharFileInfo::isCompressed</function></member> <member><function>PharFileInfo::isCompressedGZ</function></member> <member><function>PharFileInfo::setCompressedBZIP2</function></member> <member><function>PharFileInfo::setUncompressed</function></member> <member><function>PharFileInfo::setCompressedGZ</function></member> <member><function>PharData::compress</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::compressAllFilesBZIP2</function></member> <member><function>Phar::getSupportedCompression</function></member> <member><function>Phar::uncompressAllFiles</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData.xml +++ phpdoc-ja/reference/phar/PharData.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <reference xml:id="class.PharData" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> <title>PharData ã¯ã©ã¹</title> <titleabbrev>PharData</titleabbrev> <partintro> <!-- {{{ Phar intro --> <section xml:id="PharData.intro"> &reftitle.intro; <para> PharData ã¯ã©ã¹ã¯ãå®è¡å¯è½å½¢å¼ã§ãªã tar ã¢ã¼ã«ã¤ãã zip ã¢ã¼ã«ã¤ãã¸ã®ã¢ã¯ã»ã¹ãä½æã®ããã®é«ã¬ãã«ã¤ã³ã¿ã¼ãã§ã¤ã¹ãæä¾ãã¾ãã ãããã®ã¢ã¼ã«ã¤ãã«ã¯ã¹ã¿ããå«ã¾ãã¦ãããã phar æ¡å¼µã¢ã¸ã¥ã¼ã«ããå®è¡ãããã¨ã¯ã§ãã¾ããã ãã®ãããPharData ã¯ã©ã¹ã«ããé常㮠zip ããã³ tar ãã¡ã¤ã«ã®ä½æã æä½ã¯ php.ini ã® <literal>phar.readonly</literal> ã <literal>1</literal> ã§ãã£ã¦ãå¯è½ã§ãã </para> </section> <!-- }}} --> <section xml:id="PharData.synopsis"> &reftitle.classsynopsis; <!-- {{{ Synopsis --> <classsynopsis> <ooclass><classname>PharData</classname></ooclass> <!-- {{{ Class synopsis --> <classsynopsisinfo> <ooclass> <classname>PharData</classname> </ooclass> <ooclass> <modifier>extends</modifier> <classname>Phar</classname> </ooclass> </classsynopsisinfo> <!-- }}} --> <classsynopsisinfo role="comment">ããããã£</classsynopsisinfo> <classsynopsisinfo role="comment">ã¡ã½ãã</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.PharData')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> <classsynopsisinfo role="comment">ç¶æ¿ããã¡ã½ãã</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.Phar')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> </classsynopsis> <!-- }}} --> </section> </partintro> &reference.phar.entities.PharData; </reference> <!-- 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:"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 -->
http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/bbcode/book.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-ja/reference/bbcode/book.xml diff -u phpdoc-ja/reference/bbcode/book.xml:1.3 phpdoc-ja/reference/bbcode/book.xml:1.4 --- phpdoc-ja/reference/bbcode/book.xml:1.3 Sat Dec 29 04:38:37 2007 +++ phpdoc-ja/reference/bbcode/book.xml Fri Mar 28 22:01:42 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.5 Maintainer: takagi Status: ready --> <!-- Membership: external, pecl --> <book xml:id="book.bbcode" xmlns="http://docbook.org/ns/docbook"> @@ -26,6 +26,7 @@ &reference.bbcode.setup; &reference.bbcode.constants; + &reference.bbcode.reference; </book> http://cvs.php.net/viewvc.cgi/phpdoc-ja/language/oop5/overloading.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-ja/language/oop5/overloading.xml diff -u phpdoc-ja/language/oop5/overloading.xml:1.14 phpdoc-ja/language/oop5/overloading.xml:1.15 --- phpdoc-ja/language/oop5/overloading.xml:1.14 Sat Mar 1 05:55:22 2008 +++ phpdoc-ja/language/oop5/overloading.xml Fri Mar 28 22:01:42 2008 @@ -1,34 +1,93 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.25 Maintainer: hirokawa Status: ready --> -<!-- CREDITS: shimooka --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.27 Maintainer: takagi Status: ready --> +<!-- CREDITS: hirokawa,shimooka --> <sect1 xml:id="language.oop5.overloading" xmlns="http://docbook.org/ns/docbook"> <title>ãªã¼ãã¼ãã¼ã</title> <para> - ã¡ã½ããå¼ã³åºãã¨ã¡ã³ãã¼ã¸ã®ã¢ã¯ã»ã¹ã®ãããã«ã¤ãã¦ãã - __call, __get ãã㦠__set ã¡ã½ãããéãã¦ãªã¼ãã¼ãã¼ããããã¨ãã§ãã¾ãã - ãªãã¸ã§ã¯ããç¶æ¿ããããªãã¸ã§ã¯ãã - ã¢ã¯ã»ã¹ãããã¨ãã¦ãã <modifier>public</modifier> - ã¡ã³ãã¼ãããã¯ã¡ã½ãããå«ãã§ããªãå ´åã§ãã - ãããã®ã¡ã½ããã¯å®è¡ããã¾ãã - ãªã¼ãã¼ãã¼ããã¦ããå ¨ã¦ã®ã¡ã½ãã㯠- <link linkend="language.oop5.visibility">public</link> - ã¨ãã¦å®ç¾©ããã¦ããªããã°ãªãã¾ããã + PHP ã«ããããªã¼ãã¼ãã¼ãæ©è½ã¯ã + ã¡ã³ãã¼ãã¡ã½ãããåçã« + <quote>ä½æãã</quote> ããã®ææ³ã§ãã + ãããã®åçã¨ã³ãã£ãã£ã¯ããã¸ãã¯ã¡ã½ãããç¨ãã¦å¦çããã¾ãã + ãã¸ãã¯ã¡ã½ããã¯ãã¯ã©ã¹å ã§ãã¾ãã¾ãªã¢ã¯ã·ã§ã³ã«å¯¾ãã¦ç¨æãããã¨ãã§ãã¾ãã </para> + <para> - PHP 5.1.0 以éã__isset ã __unset ã¡ã½ãããéã㦠- <function>isset</function> é¢æ°ã <function>unset</function> - é¢æ°ãåã ã«ãªã¼ãã¼ãã¼ãããäºãå¯è½ã§ãã - ã¡ã½ãã __isset ã¯ã<function>empty</function> ã§ãã³ã¼ã«ããã¾ãã + ãªã¼ãã¼ãã¼ãã¡ã½ãããèµ·åããã®ã¯ã + 宣è¨ããã¦ããªãã¡ã³ãã¼ãã¡ã½ãããæä½ãããã¨ããã¨ãã§ãã + ã¾ããç¾å¨ã®ã¹ã³ã¼ããã㯠+ <link linkend="language.oop5.visibility">ã¢ã¯ã»ã¹ä¸è½ãª</link> + ã¡ã³ãã¼ãã¡ã½ãããæä½ãããã¨ããã¨ãã«ãèµ·åãã¾ãã + ãã®ã»ã¯ã·ã§ã³ã§ã¯ããããã® (宣è¨ããã¦ããªãã + ãããã¯ç¾å¨ã®ã¹ã³ã¼ãããã¯ã¢ã¯ã»ã¹ä¸è½ãª) ã¡ã³ãã¼ãã¡ã½ããã®ãã¨ã + <quote>ã¢ã¯ã»ã¹ä¸è½ã¡ã³ãã¼</quote> ããã³ + <quote>ã¢ã¯ã»ã¹ä¸è½ã¡ã½ãã</quote> + ã¨è¡¨è¨ãããã¨ã«ãã¾ãã </para> + <para> - PHP 5.3.0 ã§ã¯ã - <link linkend="language.oop5.static">static</link> - ã¡ã½ããã®ãªã¼ãã¼ãã¼ãã __callStatic ã§ã§ããããã«ãªãã¾ããã +<!-- +Test scripts indicate otherwise. +Will communicate with internals to see what's up. +http://bugs.php.net/bug.php?id=43924 +--> + ãªã¼ãã¼ãã¼ãã¡ã½ããã¯ããã¹ã¦ <literal>public</literal> + ã§å®ç¾©ããªããã°ãªãã¾ããã </para> + <note> + <para> + ãããã®ãã¸ãã¯ã¡ã½ããã®å¼æ°ã¯ã + <link linkend="functions.arguments.by-reference">åç §æ¸¡ã</link> + ã¨ãããã¨ã¯ã§ãã¾ããã + </para> + </note> + + <note> + <para> + PHP ã«ããã <quote>ãªã¼ãã¼ãã¼ã</quote> + ã®è§£éã¯ãä»ã®å¤ãã®ãªãã¸ã§ã¯ãæåè¨èªã¨ã¯ç°ãªãã¾ãã + ä¸è¬çã«ããªã¼ãã¼ãã¼ããã¨ã¯ã + ãååã¯åãã ããã©ãå¼æ°ã®æ°ãåãç°ãªãã¡ã½ãããè¤æ°ç¨æã§ããã + ã¨ããæ©è½ã®ãã¨ãæãã¾ãã + </para> + </note> + + + <sect2 xml:id="language.oop5.overloading.changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.1.0</entry> + <entry> + <literal>__isset()</literal> 㨠<literal>__unset()</literal> + ã追å ããã¾ããã + </entry> + </row> + <row> + <entry>5.3.0</entry> + <entry> + <literal>__callStatic()</literal> ã追å ããã¾ããã + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </sect2> + + <sect2 xml:id="language.oop5.overloading.members"> <title>ã¡ã³ãã¼ã®ãªã¼ãã¼ãã¼ã</title> @@ -51,121 +110,134 @@ </methodsynopsis> <para> - ç¬èªã®ã¯ã©ã¹ã§å®ç¾©ããã¦ããã«ã¹ã¿ã ã³ã¼ããå®è¡ããããã«ã - ç¹å¥ãªååãæã¤ã¡ã½ããã«ãã£ã¦ã¯ã©ã¹ã¡ã³ãã¼ããªã¼ãã¼ãã¼ã - ãããã¨ãã§ãã¾ãã - 使ç¨ããã <varname>$name</varname> ãã©ã¡ã¼ã¿ã¯ã - è¨å®ãããã¯åå¾ãããå¤æ°åã§ãã - __set() ã¡ã½ããã® <varname>$value</varname> ãã©ã¡ã¼ã¿ã«ãã - ãªãã¸ã§ã¯ãã <varname>$name</varname> ã«è¨å®ããå¤ãæå®ãã¾ãã + <literal>__set()</literal> ã¯ã + ã¢ã¯ã»ã¹ä¸è½ã¡ã³ãã¼ã¸ãã¼ã¿ãæ¸ãè¾¼ãéã«å®è¡ããã¾ãã + </para> + + <para> + <literal>__get()</literal> ã¯ã + ã¢ã¯ã»ã¹ä¸è½ã¡ã³ãã¼ãããã¼ã¿ãèªã¿è¾¼ãéã«ä½¿ç¨ãã¾ãã </para> - <note> - <para> - <literal>__set()</literal> ã¡ã½ããã§ã¯ãå¼æ°ãåç §æ¸¡ãã§åãåããã¨ã¯ã§ãã¾ããã - </para> - </note> + <para> + <literal>__isset()</literal> ã¯ã + <function>isset</function> ããã㯠<function>empty</function> + ãã¢ã¯ã»ã¹ä¸è½ã¡ã³ãã¼ã«å¯¾ãã¦å®è¡ããã¨ãã«èµ·åãã¾ãã + </para> + + <para> + <literal>__unset()</literal> ã¯ã + <function>unset</function> + ãã¢ã¯ã»ã¹ä¸è½ã¡ã³ãã¼ã«å¯¾ãã¦å®è¡ããã¨ãã«èµ·åãã¾ãã + </para> + + <para> + å¼æ° <varname>$name</varname> ã¯ã + æä½ãããã¨ããã¡ã³ãã¼ã®ååã§ãã + <literal>__set()</literal> ã¡ã½ããã®å¼æ° + <varname>$value</varname> ã¯ã + <varname>$name</varname> ã«è¨å®ãããã¨ããå¤ã¨ãªãã¾ãã + </para> + + <para> + ã¡ã³ãã¼ã®ãªã¼ãã¼ãã¼ãã¯ãªãã¸ã§ã¯ãã®ã³ã³ããã¹ãã§ã®ã¿åä½ãã¾ãã + ãããã®ãã¸ãã¯ã¡ã½ããã¯ãéçã³ã³ããã¹ãã§ã¯èµ·åãã¾ããã + ãããã£ã¦ããããã®ã¡ã½ãã㯠+ <link linkend="language.oop5.static">static</link> + 宣è¨ãããã¨ã¯ã§ãã¾ããã + </para> <example> <title>__get, __set, __isset, __unset ã使ã£ããªã¼ãã¼ãã¼ãã®ä¾</title> <programlisting role="php"> <![CDATA[ <?php -class Setter -{ - public $n; - private $x = array("a" => 1, "b" => 2, "c" => 3); - - public function __get($nm) - { - echo "Getting [$nm]\n"; - - if (isset($this->x[$nm])) { - $r = $this->x[$nm]; - print "Returning: $r\n"; - return $r; - } else { - echo "Nothing!\n"; - } +class MemberTest { + /** ãªã¼ãã¼ãã¼ãããããã¼ã¿ã®å ´æ */ + private $data = array(); + + /** 宣è¨ããã¦ããã¡ã³ãã¼ã«ã¯ãªã¼ãã¼ãã¼ãã¯èµ·åãã¾ãã */ + public $declared = 1; + + /** ã¯ã©ã¹å ããã¢ã¯ã»ã¹ããå ´åã«ã¯ãªã¼ãã¼ãã¼ãã¯èµ·åãã¾ãã */ + private $hidden = 2; + + public function __set($name, $value) { + echo "Setting '$name' to '$value'\n"; + $this->data[$name] = $value; } - public function __set($nm, $val) - { - echo "Setting [$nm] to $val\n"; - - if (isset($this->x[$nm])) { - $this->x[$nm] = $val; - echo "OK!\n"; - } else { - echo "Not OK!\n"; + public function __get($name) { + echo "Getting '$name'\n"; + if (array_key_exists($name, $this->data)) { + return $this->data[$name]; } - } - public function __isset($nm) - { - echo "Checking if $nm is set\n"; + $trace = debug_backtrace(); + trigger_error( + 'Undefined property: ' . $name . + ' in ' . $trace[0]['file'] . + ' on line ' . $trace[0]['line'], + E_USER_NOTICE); + $tmp = null; + return $tmp; + } - return isset($this->x[$nm]); + /** PHP 5.1.0 以é */ + public function __isset($name) { + echo "Is '$name' set?\n"; + return isset($this->data[$name]); } - public function __unset($nm) - { - echo "Unsetting $nm\n"; + /** PHP 5.1.0 以é */ + public function __unset($name) { + echo "Unsetting '$name'\n"; + unset($this->data[$name]); + } - unset($this->x[$nm]); + /** ãã¸ãã¯ã¡ã½ããã§ã¯ããã¾ãããåãªãä¾ã¨ãã¦ç¤ºãã¦ãã¾ã */ + public function getHidden() { + echo "'hidden' visible here so __get() not used\n"; + return $this->hidden; } } -$foo = new Setter(); -$foo->n = 1; -$foo->a = 100; -$foo->a++; -$foo->z++; - -var_dump(isset($foo->a)); //true -unset($foo->a); -var_dump(isset($foo->a)); //false - -// this doesn't pass through the __isset() method -// because 'n' is a public property -var_dump(isset($foo->n)); -var_dump($foo); +echo "<pre>\n"; + +$obj = new MemberTest; + +$obj->a = 1; +echo $obj->a . "\n"; + +var_dump(isset($obj->a)); +unset($obj->a); +var_dump(isset($obj->a)); + +echo $obj->declared . "\n"; +echo $obj->getHidden() . "\n"; +echo $obj->hidden . "\n"; ?> ]]> </programlisting> &example.outputs; <screen role="php"> <![CDATA[ -Setting [a] to 100 -OK! -Getting [a] -Returning: 100 -Setting [a] to 101 -OK! -Getting [z] -Nothing! -Setting [z] to 1 -Not OK! - -Checking if a is set +Setting 'a' to '1' +Getting 'a' +1 +Is 'a' set? bool(true) -Unsetting a -Checking if a is set +Unsetting 'a' +Is 'a' set? bool(false) -bool(true) +1 +'hidden' visible here so __get() not used +2 +Getting 'hidden' -object(Setter)#1 (2) { - ["n"]=> - int(1) - ["x":"Setter":private]=> - array(2) { - ["b"]=> - int(2) - ["c"]=> - int(3) - } -} + +Notice: Undefined property: hidden in <file> on line 64 in <file> on line 28 ]]> </screen> @@ -187,100 +259,53 @@ </methodsynopsis> <para> - ç¹å¥ãªã¡ã½ãã __call() ããã³ __callStatic() ã使ç¨ããã¨ã - åå¨ããªãã¡ã½ããã®å¼ã³åºããææãããã¨ãã§ãã¾ãã - ãããã®ã¡ã½ããã使ç¨ããã¨ãå®éã«ã³ã¼ã«ãããã¡ã½ããã®ååã«å¿ãã - ã¦ã¼ã¶å®ç¾©ã®å¦çãå®è£ ãããã¨ãã§ãã¾ãã - ããã¯ããã¨ãã°ãããã·ãå®è£ ããå ´åãªã©ã«ä¾¿å©ã§ãã - é¢æ°ã«æ¸¡ãããå¼æ°ã¯ãã©ã¡ã¼ã¿ - <varname>$arguments</varname> ã§åãåããã¨ãã§ãã - ãããã®ã¡ã½ããã®è¿ãå¤ãå¼ã³åºãå ã®ã¡ã½ããã®è¿ãå¤ã¨ãªãã¾ãã + <literal>__call()</literal> ã¯ã + ã¢ã¯ã»ã¹ä¸è½ã¡ã½ããããªãã¸ã§ã¯ãã®ã³ã³ããã¹ãã§å®è¡ããã¨ãã«èµ·åãã¾ãã </para> + <para> + <literal>__callStatic()</literal> ã¯ã + ã¢ã¯ã»ã¹ä¸è½ã¡ã½ãããéçã³ã³ããã¹ãã§å®è¡ããã¨ãã«èµ·åãã¾ãã + </para> + + <para> + å¼æ° <varname>$name</varname> ã¯ã + ã³ã¼ã«ãããã¨ããã¡ã½ããã®ååã§ãã + å¼æ° <varname>$arguments</varname> + ã¯é åã§ãã¡ã½ãã <varname>$name</varname> + ã«æ¸¡ããã¨ãããã©ã¡ã¼ã¿ãæ ¼ç´ããã¾ãã + </para> <example> - <title>__call ã«ãããã¤ã³ã¹ã¿ã³ã¹åãããã¡ã½ããã®ãªã¼ãã¼ãã¼ãã®ä¾</title> + <title>__call ããã³ ___callStatic ã«ãããã¤ã³ã¹ã¿ã³ã¹åãããã¡ã½ããã®ãªã¼ãã¼ãã¼ãã®ä¾</title> <programlisting role="php"> <![CDATA[ <?php -class Caller -{ - private $x = array(10, 20); - - public function __call($m, $a) - { - print "Instantiated method '$m' called:\n"; - var_dump($a); - return $this->x; +class MethodTest { + public function __call($name, $arguments) { + echo "Calling object method '$name' " + . implode(', ', $arguments). "\n"; } -} - -$foo = new Caller(); -$a = $foo->test('a', 'b'); -var_dump($a); -?> -]]> - </programlisting> - &example.outputs; - <screen role="php"> -<![CDATA[ - -Instantiated method 'test' called: -array(2) { - [0]=> - string(1) "a" - [1]=> - string(1) "b" -} -array(2) { - [0]=> - int(10) - [1]=> - int(20) -} -]]> - </screen> - </example> - <example> - <title>__call ã«ãããã¤ã³ã¹ã¿ã³ã¹åãããã¡ã½ããã®ãªã¼ãã¼ãã¼ãã®ä¾</title> - <programlisting role="php"> - <![CDATA[ -<?php -class Caller -{ - private static $x = array(10, 20); - - public static function __callStatic($m, $a) - { - print "Static method '$m' called:\n"; - var_dump($a); - return self::$x; + /** PHP 5.3.0 以é */ + public static function __callStatic($name, $arguments) { + echo "Calling static method '$name' " + . implode(', ', $arguments). "\n"; } } -$a = Caller::test('a', 'b'); -var_dump($a); +$obj = new MethodTest; +$obj->test('in object context'); + +MethodTest::test('in static context'); // PHP 5.3.0 以é ?> ]]> </programlisting> &example.outputs; <screen role="php"> <![CDATA[ - -Static method 'test' called: -array(2) { - [0]=> - string(1) "a" - [1]=> - string(1) "b" -} -array(2) { - [0]=> - int(10) - [1]=> - int(20) -} +Calling object method 'test' in object context +Calling static method 'test' in static context ]]> </screen> </example> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/setStub.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/setStub.xml +++ phpdoc-ja/reference/phar/PharData/setStub.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phardata.setstub"> <refnamediv> <refname>PharData::setStub</refname> <refpurpose>ããã¼é¢æ° (Phar::setStub 㯠PharData ã§ã¯ä½¿ç¨ä¸è½)</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>PharData::setStub</methodname> <methodparam><type>string</type><parameter>stub</parameter></methodparam> </methodsynopsis> <para> å®è¡å¯è½ã§ãªã tar/zip ã¢ã¼ã«ã¤ãã¯ã¹ã¿ããæã¤ãã¨ãã§ããªãã®ã§ã ãã®ã¡ã½ããã¯åã«ä¾å¤ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>stub</parameter></term> <listitem> <para> æååãããã¯ãªã¼ãã³ããã¹ããªã¼ã ãã³ãã«ã ãã® phar ã¢ã¼ã«ã¤ãã®å®è¡ã¹ã¿ãã¨ãã¦ä½¿ç¨ãã¾ãã ãã®ãã©ã¡ã¼ã¿ã¯ç¡è¦ããã¾ãã </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> ãã®ã¡ã½ãããã³ã¼ã«ãããã¨å¿ ã <classname>PharException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::setStub</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/setAlias.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/setAlias.xml +++ phpdoc-ja/reference/phar/PharData/setAlias.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xml:id="phardata.setalias" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::setAlias</refname> <refpurpose>ããã¼é¢æ° (Phar::setAlias 㯠PharData ã§ã¯ä½¿ç¨ä¸è½)</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::setAlias</methodname> <methodparam><type>string</type><parameter>alias</parameter></methodparam> </methodsynopsis> <para> å®è¡å¯è½ã§ãªã tar/zip ã¢ã¼ã«ã¤ãã¯ã¨ã¤ãªã¢ã¹ãæã¤ãã¨ãã§ããªãã®ã§ã ãã®ã¡ã½ããã¯åã«ä¾å¤ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>alias</parameter></term> <listitem> <para> ãã®ã¢ã¼ã«ã¤ããæãã¨ãã«ä½¿ç¨ããçãæååã <literal>phar</literal> ã¹ããªã¼ã ã©ããã¼ãã¢ã¯ã»ã¹ããéã«ããã使ç¨ãã¾ãã ãã®ãã©ã¡ã¼ã¿ã¯ç¡è¦ããã¾ãã </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> ãã®ã¡ã½ãããã³ã¼ã«ãããã¨å¿ ã <classname>PharException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::setAlias</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/offsetSet.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/offsetSet.xml +++ phpdoc-ja/reference/phar/PharData/offsetSet.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phardata.offsetset"> <refnamediv> <refname>PharData::offsetSet</refname> <refpurpose>tar/zip ã®å é¨ã®ãã¡ã¤ã«ã«ãå¤é¨ãã¡ã¤ã«ãããã¯æååã®å 容ãè¨å®ãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>PharData::offsetSet</methodname> <methodparam><type>string</type><parameter>offset</parameter></methodparam> <methodparam><type>string</type><parameter>value</parameter></methodparam> </methodsynopsis> <para> ãã㯠<interfacename>ArrayAccess</interfacename> ã¤ã³ã¿ã¼ãã§ã¤ã¹ãå®è£ ãããã®ã§ãã ããã«ãããtar/zip ã¢ã¼ã«ã¤ãã®å 容ã«å¯¾ãã¦é åå½¢å¼ã®è§æ¬å¼§ã使ç¨ããã¢ã¯ã»ã¹ãå¯è½ã¨ãªãã¾ãã offsetSet ã使ç¨ãã¦ãtar/zip ã¢ã¼ã«ã¤ãã®æ¢åãã¡ã¤ã«ã®å¤æ´ã æ°ãããã¡ã¤ã«ã®è¿½å ãè¡ãã¾ãã </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>offset</parameter></term> <listitem> <para> tar ããã㯠zip ã¢ã¼ã«ã¤ãå ã§å¤æ´ãããã¡ã¤ã«å (ç¸å¯¾ãã¹)ã </para> </listitem> </varlistentry> <varlistentry> <term><parameter>value</parameter></term> <listitem> <para> ãã¡ã¤ã«ã®å 容ã </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> å¤ãè¿ãã¾ããã </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Phar ã¢ã¼ã«ã¤ãã¸ã®å¤æ´ããã£ã¹ã¯ã«æ¸ãè¾¼ãéã«ä½ããã®ã¨ã©ã¼ãçºçãã㨠<classname>PharException</classname> ãã¹ãã¼ããã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>PharData::offsetSet</function> ã®ä¾</title> <para> offsetSet ã¯ç´æ¥ä½¿ç¨ãã¦ã¯ããã¾ããã é åã« <literal>[]</literal> æ¼ç®åã§ã¢ã¯ã»ã¹ããéã«ä½¿ç¨ããã¾ãã </para> <programlisting role="php"> <![CDATA[ <?php $p = new PharData('/path/to/my.tar'); try { // offsetSet ãã³ã¼ã«ããã¾ã $p['file.txt'] = 'Hi there'; } catch (Exception $e) { echo 'file.txt ãå¤æ´ã§ãã¾ãã: ', $e; } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::offsetSet</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/delMetadata.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/delMetadata.xml +++ phpdoc-ja/reference/phar/PharData/delMetadata.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xml:id="phardata.delmetadata" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::delMetadata</refname> <refpurpose>zip ã¢ã¼ã«ã¤ãã®ã°ãã¼ãã«ã¡ã¿ãã¼ã¿ãåé¤ãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>PharData::delMetadata</methodname> <void/> </methodsynopsis> &phar.write; <para> zip ã¢ã¼ã«ã¤ãã®ã°ãã¼ãã«ã¡ã¿ãã¼ã¿ãåé¤ãã¾ãã </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> æåããå ´åã« &true; ãè¿ãã¾ããããããããå®å ¨ãæããªã ä¾å¤ãã¹ãã¼ãããªããã¨ã確èªããã¨ããã§ãããã </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> å¤æ´ããã£ã¹ã¯ã«æ¸ãæ»ãéã«ã¨ã©ã¼ãçºçããå ´å㯠<classname>PharException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>PharData::delMetaData</function> ã®ä¾</title> <programlisting role="php"> <![CDATA[ <?php try { $phar = new PharData('myphar.zip'); var_dump($phar->getMetadata()); $phar->setMetadata("hi there"); var_dump($phar->getMetadata()); $phar->delMetadata(); var_dump($phar->getMetadata()); } catch (Exception $e) { // ã¨ã©ã¼å¦ç } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ NULL string(8) "hi there" NULL ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::delMetadata</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/copy.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/copy.xml +++ phpdoc-ja/reference/phar/PharData/copy.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xml:id="phardata.copy" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::copy</refname> <refpurpose>phar ã¢ã¼ã«ã¤ãå ã®ãã¡ã¤ã«ããphar å ã§å¥ã®æ°ãããã¡ã¤ã«ã¨ãã¦ã³ãã¼ãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::copy</methodname> <methodparam><type>string</type><parameter>oldfile</parameter></methodparam> <methodparam><type>string</type><parameter>newfile</parameter></methodparam> </methodsynopsis> <para> phar ã¢ã¼ã«ã¤ãå ã®ãã¡ã¤ã«ãããã®ã¢ã¼ã«ã¤ãå ã§å¥ã®æ°ãããã¡ã¤ã«ã¨ãã¦ã³ãã¼ãã¾ãã ããã¯ãphar ã¹ããªã¼ã ã©ããã¼ã§ã® <function>copy</function> ã¨åçã®æä½ããªãã¸ã§ã¯ãæåã§è¡ããã®ã§ãã </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>oldfile</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>newfile</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> æåããå ´åã« &true; ãè¿ãã¾ããããããããå®å ¨ãæããªã try/catch ãããã¯å ã§ä½¿ç¨ãã¦ä¾å¤ãã¹ãã¼ãããªããã¨ã確èªããã¨ããã§ãããã </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> ã³ãã¼å ã®ãã¡ã¤ã«ãåå¨ããªããã³ãã¼å ã®ãã¡ã¤ã«ãæ¢ã«åå¨ããã æ¸ãè¾¼ã¿ã¢ã¯ã»ã¹ãç¡å¹ã«ãªã£ã¦ãããã©ã¡ããã®ãã¡ã¤ã«ã®ãªã¼ãã³ã«å¤±æããã ãããã¯ã³ãã¼å ã®ãã¡ã¤ã«ã®èªã¿è¾¼ã¿ã«å¤±æããå ´åã« <classname>UnexpectedValueException</classname> ãã¹ãã¼ãã¾ãã å¤æ´å 容㮠phar ã¸ã®æ¸ãè¾¼ã¿ã«å¤±æããå ´å㯠<classname>PharException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>PharData::copy</function> ã®ä¾</title> <para> ãã®ä¾ã¯ã<function>PharData::copy</function> ã®ä½¿ç¨æ³ã®ã»ãã« ããã¨åçã®æä½ãã¹ããªã¼ã ã©ããã¼ã§è¡ãæ¹æ³ã示ããã®ã§ãã ãããã®æ¹å¼ã®æ大ã®éãã¯ã¨ã©ã¼å¦çã§ãã PharData ã®ãã¹ã¦ã®ã¡ã½ããã¯ä¾å¤ãã¹ãã¼ãã¾ãããã¹ããªã¼ã ã©ããã¼ã®å ´å㯠<function>trigger_error</function> ã使ç¨ãã¾ãã </para> <programlisting role="php"> <![CDATA[ <?php try { $phar = new PharData('myphar.tar'); $phar['a'] = 'hi'; $phar->copy('a', 'b'); echo $phar['b']; // åºå㯠"hi" } catch (Exception $e) { // ã¨ã©ã¼å¦ç } // ä¸ã®ã³ã¼ãã¨åçã®å¦çãã¹ããªã¼ã ã©ããã¼ã§è¡ãä¾ã // ã¨ã©ã¼æã«ã¯ä¾å¤ã§ã¯ãªã E_WARNINGS ãçºçãã¾ã copy('phar://myphar.tar/a', 'phar//myphar.tar/c'); echo file_get_contents('phar://myphar.tar/c'); // åºå㯠"hi" ?> ]]> </programlisting> </example> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/convertToZip.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/convertToZip.xml +++ phpdoc-ja/reference/phar/PharData/convertToZip.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xml:id="phardata.converttozip" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::convertToZip</refname> <refpurpose>tar ã¢ã¼ã«ã¤ãã zip ãã¡ã¤ã«å½¢å¼ã«å¤æãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::convertToZip</methodname> <methodparam><type>string</type><parameter>extension</parameter></methodparam> </methodsynopsis> <para> ãã®ã¡ã½ããã¯ãphar å½¢å¼ããã㯠tar å½¢å¼ã® phar ã¢ã¼ã«ã¤ãã zip ãã¡ã¤ã«å½¢å¼ã«å¤æãã¾ãã </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>extension</parameter></term> <listitem> <para> ããã©ã«ãã§ã¯ãtar ã¢ã¼ã«ã¤ãããå¤æããéã®æ¡å¼µå㯠<literal>.zip</literal> ã¨ãªãã¾ãã </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> ãã®ã¡ã½ããã¯ãæåããå ´åã« <classname>PharData</classname> ãªãã¸ã§ã¯ããè¿ãã¾ãã 失æããå ´åã«ã¯ä¾å¤ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> å§ç¸®ãã§ããªãå ´åãç¡å¹ãªå§ç¸®æ¹å¼ãæå®ãããå ´åãããã㯠<function>Phar::startBuffering</function> ã§ãããã¡ãªã³ã°ããã¾ã¾ <function>Phar::stopBuffering</function> ãå®è¡ãã¦ããªãã¢ã¼ã«ã¤ããå¦çãããã¨ããå ´åã« <classname>BadMethodCallException</classname> ãã¹ãã¼ãã¾ãã ã¾ããæ¸ãè¾¼ã¿ãµãã¼ããç¡å¹ãªå ´åã« <classname>UnexpectedValueException</classname>ã zip ä½æä¸ã«ä½ããã®åé¡ãçºçããå ´åã« <classname>PharException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>PharData::convertToZip</function> ã®ä¾</title> <para> PharData::convertToZip() ã®ä½¿ç¨æ³ã§ãã </para> <programlisting role="php"> <![CDATA[ <?php try { $tar = new PharData('myphar.tar.gz'); // zip ãã¡ã¤ã«å½¢å¼ã«å¤æãã¾ã $zip = $tar->convertToZip(); } catch (Exception $e) { // ããã§ã¨ã©ã¼å¦çããã¾ã } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::convertToZip</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/convertToTar.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/convertToTar.xml +++ phpdoc-ja/reference/phar/PharData/convertToTar.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xml:id="phardata.converttotar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::convertToTar</refname> <refpurpose>zip ã¢ã¼ã«ã¤ãã tar ãã¡ã¤ã«å½¢å¼ã«å¤æãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::convertToTar</methodname> <methodparam><type>string</type><parameter>extension</parameter></methodparam> </methodsynopsis> <para> ãã®ã¡ã½ããã¯ãphar å½¢å¼ããã㯠zip å½¢å¼ã® phar ã¢ã¼ã«ã¤ãã tar ãã¡ã¤ã«å½¢å¼ã«å¤æãã¾ãã </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>extension</parameter></term> <listitem> <para> ããã©ã«ãã§ã¯ãzip ã¢ã¼ã«ã¤ãããå¤æããéã®æ¡å¼µå㯠<literal>.tar</literal> ã¨ãªãã¾ãã </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> ãã®ã¡ã½ããã¯ãæåããå ´åã« <classname>PharData</classname> ãªãã¸ã§ã¯ããè¿ãã¾ãã 失æããå ´åã«ã¯ä¾å¤ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> å§ç¸®ãã§ããªãå ´åãç¡å¹ãªå§ç¸®æ¹å¼ãæå®ãããå ´åãããã㯠<function>Phar::startBuffering</function> ã§ãããã¡ãªã³ã°ããã¾ã¾ <function>Phar::stopBuffering</function> ãå®è¡ãã¦ããªãã¢ã¼ã«ã¤ããå¦çãããã¨ããå ´åã« <classname>BadMethodCallException</classname> ãã¹ãã¼ãã¾ãã ã¾ããæ¸ãè¾¼ã¿ãµãã¼ããç¡å¹ãªå ´åã« <classname>UnexpectedValueException</classname>ã tar ä½æä¸ã«ä½ããã®åé¡ãçºçããå ´åã« <classname>PharException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>PharData::convertToTar</function> ã®ä¾</title> <para> PharData::convertToTar() ã®ä½¿ç¨æ³ã§ãã </para> <programlisting role="php"> <![CDATA[ <?php try { $zip = new PharData('myphar.zip'); $tar = $zip->convertToTar(); } catch (Exception $e) { // ããã§ã¨ã©ã¼å¦çããã¾ã } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::convertToTar</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/convertToPhar.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/convertToPhar.xml +++ phpdoc-ja/reference/phar/PharData/convertToPhar.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xml:id="phardata.converttophar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::convertToPhar</refname> <refpurpose>tar/zip ã¢ã¼ã«ã¤ãã phar ãã¡ã¤ã«å½¢å¼ã«å¤æãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::convertToPhar</methodname> <methodparam><type>string</type><parameter>extension</parameter></methodparam> </methodsynopsis> &phar.write; <para> ãã®ã¡ã½ããã¯ãtar/zip ã¢ã¼ã«ã¤ãã å®è¡å¯è½ãª phar ãã¡ã¤ã«å½¢å¼ã«å¤æãã¾ãã </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>extension</parameter></term> <listitem> <para> ããã©ã«ãã®æ¡å¼µåã¯ãæªå§ç¸®ã® tar ã¢ã¼ã«ã¤ãããã㯠zip ã¢ã¼ã«ã¤ãããå¤æããå ´å㯠<literal>.phar</literal> ã¨ãªãã¾ããã¾ã zlib å§ç¸®ããã tar ã¢ã¼ã«ã¤ãããå¤æããå ´å㯠<literal>.phar.gz</literal>ãbzip2 å§ç¸®ããã tar ã¢ã¼ã«ã¤ãããå¤æããå ´å㯠<literal>.phar.bz2</literal> ã¨ãªãã¾ãã </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> ãã®ã¡ã½ããã¯ãæåããå ´åã« <classname>Phar</classname> ãªãã¸ã§ã¯ããè¿ãã¾ãã 失æããå ´åã«ã¯ä¾å¤ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> å§ç¸®ãã§ããªãå ´åãç¡å¹ãªå§ç¸®æ¹å¼ãæå®ãããå ´åãããã㯠<function>Phar::startBuffering</function> ã§ãããã¡ãªã³ã°ããã¾ã¾ <function>Phar::stopBuffering</function> ãå®è¡ãã¦ããªãã¢ã¼ã«ã¤ããå¦çãããã¨ããå ´åã« <classname>BadMethodCallException</classname> ãã¹ãã¼ãã¾ãã ã¾ããæ¸ãè¾¼ã¿ãµãã¼ããç¡å¹ãªå ´åã« <classname>UnexpectedValueException</classname>ã phar ä½æä¸ã«ä½ããã®åé¡ãçºçããå ´åã« <classname>PharException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>PharData::convertToPhar</function> ã®ä¾</title> <para> PharData::convertToPhar() ã®ä½¿ç¨æ³ã§ãã </para> <programlisting role="php"> <![CDATA[ <?php try { $tarphar = new PharData('myphar.tar'); // phar ãã©ã¼ãããã«å¤æãã¾ã // myphar.tar ã¯åé¤ããããªãããã¨ã«æ³¨æãã¾ããã $phar = $tarphar->convertToPhar(); // creates myphar.phar $phar->setStub($phar->createDefaultStub('cli.php', 'web/index.php')); } catch (Exception $e) { // ããã§ã¨ã©ã¼å¦çããã¾ã } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::convertToPhar</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/construct.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/construct.xml +++ phpdoc-ja/reference/phar/PharData/construct.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="phardata.construct"> <refnamediv> <refname>PharData::__construct</refname> <refpurpose>å®è¡å¯è½ã§ãªã tar ããã㯠zip ã¢ã¼ã«ã¤ããªãã¸ã§ã¯ããä½æãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>PharData::__construct</methodname> <methodparam><type>string</type><parameter>fname</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>fname</parameter></term> <listitem> <para> æ¢åã® tar/zip ã¢ã¼ã«ã¤ããããã¯ä½æãããã¢ã¼ã«ã¤ãã¸ã®ãã¹ã </para> </listitem> </varlistentry> <varlistentry> <term><parameter>flags</parameter></term> <listitem> <para> 親ã¯ã©ã¹ <classname>Phar</classname> ã® <classname>RecursiveDirectoryIterator</classname> ã«æ¸¡ããã©ã°ã <link xlink:href="http://www.php.net/~helly/php/ext/spl/classRecursiveDirectoryIterator.html#be0e1176d512c66500e5c26f248c89c4">SPL RecursiveDirectoryIterator ã®ããã¥ã¡ã³ã</link> ãåç §ãã ããã </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> 2 度ã³ã¼ã«ãããå ´åã« BadMethodCallExceptionã phar ã¢ã¼ã«ã¤ãã®ãªã¼ãã³ã«å¤±æããå ´åã« UnexpectedValueException ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>PharData::__construct</function> ã®ä¾</title> <para> <programlisting role="php"> <![CDATA[ <?php try { $p = new PharData('/path/to/my.tar', CURRENT_AS_FILEINFO | KEY_AS_FILENAME); } catch (UnexpectedValueException $e) { die('Could not open my.tar'); } catch (BadMethodCallException $e) { echo 'technically, this cannot happen'; } echo file_get_contents('phar:///path/to/my.tar/example.txt'); ?> ]]> </programlisting> </para> </example> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/compressAllFilesGZ.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/compressAllFilesGZ.xml +++ phpdoc-ja/reference/phar/PharData/compressAllFilesGZ.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phardata.compressallfilesgz"> <refnamediv> <refname>PharData::compressAllFilesGZ</refname> <refpurpose>ç¾å¨ã® tar/zip ã¢ã¼ã«ã¤ãå ã®ãã¹ã¦ã®ãã¡ã¤ã«ã Gzip ã§å§ç¸®ãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::compressAllFilesGZ</methodname> <void/> </methodsynopsis> <para> tar ã¢ã¼ã«ã¤ãã®å ´åããã®ã¡ã½ããã¯å¤±æã㦠<classname>PharException</classname> ã¨ãªãã¾ãã tar ãã©ã¼ãããã§åå¥ã®ãã¡ã¤ã«ãå§ç¸®ãããã¨ã¯ã§ããªãããã§ãã tar ã¢ã¼ã«ã¤ãå ¨ä½ãå§ç¸®ããã«ã¯ <function>PharData::compress</function> ã使ç¨ãã¾ãã </para> <para> zip ã¢ã¼ã«ã¤ãã®å ´åã¯ããã®ã¡ã½ãã㯠Phar ã¢ã¼ã«ã¤ãå ã®ãã¹ã¦ã®ãã¡ã¤ã«ã gzip ã§å§ç¸®ãã¾ãã ãã®æ©è½ã使ç¨ããã«ã¯ <link linkend="ref.zlib">zlib</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ãæå¹ã«ãªã£ã¦ããªããã°ãªãã¾ããã ã¾ãããã§ã« bzip2 ã§å§ç¸®ããã¦ãããã¡ã¤ã«ãå¦çããããã«ã¯ã ã¾ã bzip2 ã伸張ãã¦ãã gzip ã§åå§ç¸®ããããã <link linkend="ref.bzip2">bzip2</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ãæå¹ã«ãªã£ã¦ããªããã°ãªãã¾ããã </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> INI è¨å® <link linkend="ini.phar.readonly">phar.readonly</link> ã on ã®å ´åã<link linkend="ref.zlib">zlib</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ã使ç¨ã§ããªãå ´åãããã㯠bzip2 ã§å§ç¸®ããããã¡ã¤ã«ãããã®ã« <link linkend="ref.bzip2">bzip2</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ã使ç¨ã§ããªãå ´åã« <classname>BadMethodCallException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>PharData::compressAllFilesGZ</function> ã®ä¾</title> <programlisting role="php"> <![CDATA[ <?php $p = new PharData('/path/to/my.zip'); $p['myfile.txt'] = 'hi'; $p['myfile2.txt'] = 'hi'; foreach ($p as $file) { var_dump($file->getFileName()); var_dump($file->isCompressed()); var_dump($file->isCompressedBZIP2()); var_dump($file->isCompressedGZ()); } $p->compressAllFilesGZ(); foreach ($p as $file) { var_dump($file->getFileName()); var_dump($file->isCompressed()); var_dump($file->isCompressedBZIP2()); var_dump($file->isCompressedGZ()); } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ string(10) "myfile.txt" bool(false) bool(false) bool(false) string(11) "myfile2.txt" bool(false) bool(false) bool(false) string(10) "myfile.txt" bool(true) bool(false) bool(true) string(11) "myfile2.txt" bool(true) bool(false) bool(true) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::compressAllFilesGZ</function></member> <member><function>PharData::compress</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/compressAllFilesBZIP2.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/compressAllFilesBZIP2.xml +++ phpdoc-ja/reference/phar/PharData/compressAllFilesBZIP2.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phardata.compressallfilesbzip2"> <refnamediv> <refname>PharData::compressAllFilesBZIP2</refname> <refpurpose>ç¾å¨ã® tar/zip ã¢ã¼ã«ã¤ãå ã®ãã¹ã¦ã®ãã¡ã¤ã«ã Bzip2 ã§å§ç¸®ãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::compressAllFilesBZIP2</methodname> <void/> </methodsynopsis> <para> tar ã¢ã¼ã«ã¤ãã®å ´åããã®ã¡ã½ããã¯å¤±æã㦠<classname>PharException</classname> ã¨ãªãã¾ãã tar ãã©ã¼ãããã§åå¥ã®ãã¡ã¤ã«ãå§ç¸®ãããã¨ã¯ã§ããªãããã§ãã tar ã¢ã¼ã«ã¤ãå ¨ä½ãå§ç¸®ããã«ã¯ <function>PharData::compress</function> ã使ç¨ãã¾ãã </para> <para> ãã®ã¡ã½ããã¯ãzip ã¢ã¼ã«ã¤ãå ã®ãã¹ã¦ã®ãã¡ã¤ã«ã bzip2 ã§å§ç¸®ãã¾ãããã®æ©è½ã使ç¨ããã«ã¯ <link linkend="ref.bzip2">bzip2</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ãæå¹ã«ãªã£ã¦ããªããã°ãªãã¾ããã ã¾ãããã§ã« gzip ã§å§ç¸®ããã¦ãããã¡ã¤ã«ãå¦çããããã«ã¯ã ã¾ã gzip ã伸張ãã¦ãã bzip2 ã§åå§ç¸®ããããã <link linkend="ref.zlib">zlib</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ãæå¹ã«ãªã£ã¦ããªããã°ãªãã¾ããã </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> <link linkend="ref.bzip2">bzip2</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ã使ç¨ã§ããªãå ´åãããã㯠gzip ã§å§ç¸®ããããã¡ã¤ã«ãããã®ã« <link linkend="ref.zlib">zlib</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ã使ç¨ã§ããªãå ´åã« <classname>BadMethodCallException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>PharData::compressAllFilesBZIP2</function> ã®ä¾</title> <programlisting role="php"> <![CDATA[ <?php $p = new PharData('/path/to/my.zip'); $p['myfile.txt'] = 'hi'; $p['myfile2.txt'] = 'hi'; foreach ($p as $file) { var_dump($file->getFileName()); var_dump($file->isCompressed()); var_dump($file->isCompressedBZIP2()); var_dump($file->isCompressedGZ()); } $p->compressAllFilesBZIP2(); foreach ($p as $file) { var_dump($file->getFileName()); var_dump($file->isCompressed()); var_dump($file->isCompressedBZIP2()); var_dump($file->isCompressedGZ()); } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ string(10) "myfile.txt" bool(false) bool(false) bool(false) string(11) "myfile2.txt" bool(false) bool(false) bool(false) string(10) "myfile.txt" bool(true) bool(true) bool(false) string(11) "myfile2.txt" bool(true) bool(true) bool(false) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::compressAllFilesBZIP2</function></member> <member><function>PharData::compress</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData/buildFromIterator.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData/buildFromIterator.xml +++ phpdoc-ja/reference/phar/PharData/buildFromIterator.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry xml:id="phardata.buildfromiterator" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::buildFromIterator</refname> <refpurpose>ã¤ãã¬ã¼ã¿ãã tar ããã㯠zip ã¢ã¼ã«ã¤ããä½æãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>PharData::buildFromIterator</methodname> <methodparam><type>Iterator</type><parameter>iter</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>base_directory</parameter></methodparam> </methodsynopsis> <para> tar ããã㯠zip ã¢ã¼ã«ã¤ããã¤ãã¬ã¼ã¿ããä½æãã¾ãã ãµãã¼ãããã¤ãã¬ã¼ã¿ã¯äºç¨®é¡ã§ã tar/zip å ã®ãã¡ã¤ã«åã¨ãã£ã¹ã¯ä¸ã®å®éã®ãã¡ã¤ã«åã対å¿ããããã®ããããã㯠DirectoryIterator ã®ããã« SplFileInfo ãªãã¸ã§ã¯ããè¿ããã®ã§ãã SplFileInfo ãªãã¸ã§ã¯ããè¿ãã¤ãã¬ã¼ã¿ã®å ´åã¯ã2 çªç®ã®ãã©ã¡ã¼ã¿ãå¿ è¦ã¨ãªãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>SplFileInfo ã使ç¨ãã <function>PharData::buildFromIterator</function> ã®ä¾</title> <para> ã»ã¨ãã©ã® tar/zip ã¢ã¼ã«ã¤ãã¯ãå®éã®ãã£ã¬ã¯ããªæ§é ãåæ ããå½¢å¼ã«ãªã£ã¦ãã¾ãã ãã®ãããªå ´å㯠2 çªç®ã®æ¹å¼ãæé©ã§ãã ãã¨ãã°ã次ã®ãããªãã£ã¬ã¯ããªæ§æã®ãã¡ã¤ã«ãå«ã tar/zip ã¢ã¼ã«ã¤ããä½æãã¦ã¿ããã¨ã«ãã¾ãããã </para> <para> <screen> <![CDATA[ /path/to/project/ config/ dist.xml debug.xml lib/ file1.php file2.php src/ processthing.php www/ index.php cli/ index.php ]]> </screen> </para> <para> 次ã®ã³ã¼ãã使ç¨ããã¨ããããã®ãã¡ã¤ã«ã tar ã¢ã¼ã«ã¤ã "project.tar" ã«è¿½å ãã¾ãã </para> <para> <programlisting role="php"> <![CDATA[ <?php $phar = new PharData('project.tar'); $phar->buildFromIterator( new RecursiveIteratorIterator( new RecursiveDirectoryIterator('/path/to/project')), '/path/to/project'); ?> ]]> </programlisting> </para> <para> ããã§ããã¡ã¤ã« <literal>project.tar</literal> ã¯ããã«ä½¿ããããã«ãªãã¾ãã <function>buildFromIterator</function> ã¯å§ç¸®ãã¡ã¿ãã¼ã¿ã®è¨å®ãè¡ãã¾ããã ããã㯠tar/zip ã¢ã¼ã«ã¤ããä½æããå¾ã§è¡ããã¨ãã§ãã¾ãã </para> <para> èå³æ·±ããã¨ã«ã<function>buildFromIterator</function> ã使ç¨ãã¦æ¢åã® phar ã tarãããã㯠zip ã¢ã¼ã«ã¤ãã®ä¸èº«ãã³ãã¼ãããã¨ãã§ãã¾ãã ã¨ããã®ã PharData ãªãã¸ã§ã¯ã㯠<classname>DirectoryIterator</classname> ãç¶æ¿ãã¦ããããã§ãã </para> <para> <programlisting role="php"> <![CDATA[ <?php $phar = new PharData('project.tar'); $phar->buildFromIterator( new RecursiveIteratorIterator( new Phar('/path/to/anotherphar.phar')), 'phar:///path/to/anotherphar.phar/path/to/project'); $phar->setStub($phar->createDefaultWebStub('cli/index.php', 'www/index.php')); ?> ]]> </programlisting> </para> </example> <example> <title>ãã®ä»ã®ã¤ãã¬ã¼ã¿ã使ç¨ãã <function>PharData::buildFromIterator</function> ã®ä¾</title> <para> ãã以å¤ã®å½¢å¼ã®ã¤ãã¬ã¼ã¿ã§ã¯ã key => value ã®å¯¾å¿ãè¿ããã®ã使ç¨ã§ãã¾ãããã¨ãã° <classname>ArrayIterator</classname> ãªã©ã§ãã </para> <para> <programlisting role="php"> <![CDATA[ <?php $phar = new PharData('project.tar'); $phar->buildFromIterator( new ArrayIterator( array( 'internal/file.php' => dirname(__FILE__) . '/somefile.php', 'another/file.jpg' => fopen('/path/to/bigfile.jpg', 'rb'), ))); ?> ]]> </programlisting> </para> </example> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>iter</parameter></term> <listitem> <para> phar ãã¡ã¤ã«ã¨å®éã®å ´æã®é¢é£ãè¿ãã¤ãã¬ã¼ã¿ã ããã㯠SplFileInfo ãªãã¸ã§ã¯ããè¿ãã¤ãã¬ã¼ã¿ã </para> </listitem> </varlistentry> <varlistentry> <term><parameter>base_directory</parameter></term> <listitem> <para> SplFileInfo ãªãã¸ã§ã¯ããè¿ãã¤ãã¬ã¼ã¿ãæå®ããéã tar/zip ã¢ã¼ã«ã¤ãã¸ã®è¿½å æã«ãã«ãã¹ããåãé¤ãé¨åã </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <function>buildFromIterator</function> ã¯é£æ³é åãè¿ãã¾ãã ããã¯ããã¡ã¤ã«ã®å é¨ãã¹ã¨ãã¡ã¤ã«ã·ã¹ãã ä¸ã®ãã«ãã¹ã対å¿ããããã®ã§ãã </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> ãã®ã¡ã½ããã¯ãã¤ãã¬ã¼ã¿ãééã£ãå¤ (ãã¨ãã°æååãã¼ã§ã¯ãªãæ´æ°ãã¼ãªã©) ãè¿ããå ´åã« <classname>UnexpectedValueException</classname> ãè¿ãã¾ããã¾ããSplFileInfo åã®ã¤ãã¬ã¼ã¿ã渡ããã¨ãã« <parameter>base_directory</parameter> ãæå®ããªãã£ãå ´å㯠<classname>BadMethodCallException</classname> ãã phar ã¢ã¼ã«ã¤ãã®ä¿åæã«ã¨ã©ã¼ãçºçããå ´å㯠<classname>PharException</classname> ãè¿ãã¾ãã </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::buildFromIterator</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/Phar/compress.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/Phar/compress.xml +++ phpdoc-ja/reference/phar/Phar/compress.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.compress"> <refnamediv> <refname>Phar::compress</refname> <refpurpose>Phar ã¢ã¼ã«ã¤ãå ¨ä½ã Gzip ããã㯠Bzip2 ã§å§ç¸®ãã</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>object</type><methodname>Phar::compress</methodname> <methodparam><type>int</type><parameter>compression</parameter></methodparam> </methodsynopsis> &phar.write; <para> tar å½¢å¼ããã㯠phar å½¢å¼ã® phar ã¢ã¼ã«ã¤ãã®å ´åã¯ã ãã®ã¡ã½ããã¯ã¢ã¼ã«ã¤ãå ¨ä½ã gzip ããã㯠bzip2 ã§å§ç¸®ãã¾ãã ã§ãããã£ããã¡ã¤ã«ã¯ gunzip/bunzip ã³ãã³ãã§å¦çãããã¨ãã§ãã¾ããã Phar æ¡å¼µã¢ã¸ã¥ã¼ã«ã§ç´æ¥ééçã«ä½¿ç¨ãããã¨ãã§ãã¾ãã </para> <para> zip å½¢å¼ã® phar ã¢ã¼ã«ã¤ãã®å ´åã¯ããã®ã¡ã½ããã¯å¤±æãã¦ä¾å¤ãçºçãã¾ãã gzip ã§å§ç¸®ããããã«ã¯ <link linkend="ref.zlib">zlib</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ãããã㦠bzip2 ã§å§ç¸®ããããã«ã¯ <link linkend="ref.bzip2">bzip2</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ãæå¹ã«ãªã£ã¦ããªããã°ãªãã¾ããã ãã®é¢æ°ã¯ phar ã®å 容ãå¤æ´ããã®ã§ã使ç¨ããã«ã¯ INI è¨å® <link linkend="ini.phar.readonly">phar.readonly</link> ã off ã«ãªã£ã¦ããªããã°ãªãã¾ããã </para> <para> ããã«ããã®ã¡ã½ããã¯èªåçã«ã¢ã¼ã«ã¤ãã®ååãå¤æ´ãã <literal>.gz</literal> ããã㯠<literal>.bz2</literal> ã追å ãã¾ãã<literal>Phar::NONE</literal> ã渡ãã¦å§ç¸®ã解é¤ããå ´åã¯æ¡å¼µåãåé¤ãã¾ãã </para> <para> <classname>Phar</classname> ãªãã¸ã§ã¯ããè¿ãã¾ãã </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>compression</parameter></term> <listitem> <para> å§ç¸®ãè¡ãå ´åã«ã¯ <literal>Phar::GZ</literal> ããã㯠<literal>Phar::BZ2</literal>ãå§ç¸®ã解é¤ããå ´åã«ã¯ <literal>Phar::NONE</literal> ãæå®ãã¾ãã </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> INI è¨å® <link linkend="ini.phar.readonly">phar.readonly</link> ã on ã®å ´åã<link linkend="ref.zlib">zlib</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ã使ç¨ã§ããªãå ´åãããã㯠<link linkend="ref.bzip2">bzip2</link> æ¡å¼µã¢ã¸ã¥ã¼ã«ã使ç¨ã§ããªãå ´åã« <classname>BadMethodCallException</classname> ãã¹ãã¼ãã¾ãã </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>Phar::compress</function> ã®ä¾</title> <programlisting role="php"> <![CDATA[ <?php $p = new Phar('/path/to/my.phar', 0, 'my.phar'); $p['myfile.txt'] = 'hi'; $p['myfile2.txt'] = 'hi'; $p1 = $p->compress(Phar::GZ); // /path/to/my.phar.gz ã«ã³ãã¼ãã¾ã $p2 = $p->compress(Phar::BZ2); // /path/to/my.phar.bz2 ã«ã³ãã¼ãã¾ã $p3 = $p2->compress(Phar::NONE); // ä¾å¤: /path/to/my.phar ã¯æ¢ã«åå¨ãã¾ã ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::getCompressedSize</function></member> <member><function>PharFileInfo::isCompressedBZIP2</function></member> <member><function>PharFileInfo::isCompressed</function></member> <member><function>PharFileInfo::isCompressedGZ</function></member> <member><function>PharFileInfo::setCompressedBZIP2</function></member> <member><function>PharFileInfo::setUncompressed</function></member> <member><function>PharFileInfo::setCompressedGZ</function></member> <member><function>PharData::compress</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::compressAllFilesBZIP2</function></member> <member><function>Phar::getSupportedCompression</function></member> <member><function>Phar::uncompressAllFiles</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/phar/PharData.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/phar/PharData.xml +++ phpdoc-ja/reference/phar/PharData.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <reference xml:id="class.PharData" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> <title>PharData ã¯ã©ã¹</title> <titleabbrev>PharData</titleabbrev> <partintro> <!-- {{{ Phar intro --> <section xml:id="PharData.intro"> &reftitle.intro; <para> PharData ã¯ã©ã¹ã¯ãå®è¡å¯è½å½¢å¼ã§ãªã tar ã¢ã¼ã«ã¤ãã zip ã¢ã¼ã«ã¤ãã¸ã®ã¢ã¯ã»ã¹ãä½æã®ããã®é«ã¬ãã«ã¤ã³ã¿ã¼ãã§ã¤ã¹ãæä¾ãã¾ãã ãããã®ã¢ã¼ã«ã¤ãã«ã¯ã¹ã¿ããå«ã¾ãã¦ãããã phar æ¡å¼µã¢ã¸ã¥ã¼ã«ããå®è¡ãããã¨ã¯ã§ãã¾ããã ãã®ãããPharData ã¯ã©ã¹ã«ããé常㮠zip ããã³ tar ãã¡ã¤ã«ã®ä½æã æä½ã¯ php.ini ã® <literal>phar.readonly</literal> ã <literal>1</literal> ã§ãã£ã¦ãå¯è½ã§ãã </para> </section> <!-- }}} --> <section xml:id="PharData.synopsis"> &reftitle.classsynopsis; <!-- {{{ Synopsis --> <classsynopsis> <ooclass><classname>PharData</classname></ooclass> <!-- {{{ Class synopsis --> <classsynopsisinfo> <ooclass> <classname>PharData</classname> </ooclass> <ooclass> <modifier>extends</modifier> <classname>Phar</classname> </ooclass> </classsynopsisinfo> <!-- }}} --> <classsynopsisinfo role="comment">ããããã£</classsynopsisinfo> <classsynopsisinfo role="comment">ã¡ã½ãã</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.PharData')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> <classsynopsisinfo role="comment">ç¶æ¿ããã¡ã½ãã</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.Phar')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> </classsynopsis> <!-- }}} --> </section> </partintro> &reference.phar.entities.PharData; </reference> <!-- 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:"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 -->