-
Notifications
You must be signed in to change notification settings - Fork 58
/
convertToData.xml
190 lines (180 loc) · 6.92 KB
/
convertToData.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f03806fcd8fe03a0501bd40b6e3939ff6589a1d2 Maintainer: takagi Status: ready -->
<refentry xml:id="phardata.converttodata" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>PharData::convertToData</refname>
<refpurpose>phar アーカイブを実行可能でない tar あるいは zip ファイルに変換する</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="PharData">
<modifier>public</modifier> <type class="union"><type>PharData</type><type>null</type></type><methodname>PharData::convertToData</methodname>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>format</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>compression</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>extension</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
このメソッドは、実行可能でない tar あるいは zip アーカイブを別の実行可能でない形式に変換します。
</para>
<para>
何も変更しなかった場合、このメソッドは
<classname>BadMethodCallException</classname> をスローします。
このメソッドは、tar アーカイブを zip 形式に変換するか
あるいはその逆の変換をする場合に使用するものです。
このメソッドで単に tar アーカイブの圧縮方法だけを変更することもできますが、
その場合は <function>PharData::compress</function> を使うことをおすすめします。
</para>
<para>
成功した場合は、このメソッドはディスク上に新しいアーカイブを作成して
<classname>PharData</classname> オブジェクトを返します。
古いアーカイブは削除されずディスク上に残るので、
処理を終えたら手動で削除する必要があります。
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>format</parameter></term>
<listitem>
<para>
これは <literal>Phar::TAR</literal>
あるいは <literal>Phar::ZIP</literal> のいずれかとなります。
&null; を指定すると、現在のファイル形式をそのまま保持します。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>compression</parameter></term>
<listitem>
<para>
アーカイブ全体の圧縮を行わない場合は <literal>Phar::NONE</literal>、
zlib による圧縮の場合は <literal>Phar::GZ</literal>、そして bzip による圧縮の場合は
<literal>Phar::BZ2</literal> のいずれかを指定します。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>extension</parameter></term>
<listitem>
<para>
このパラメータは、変換後のアーカイブのデフォルトのファイル拡張子を変更します。
実行可能でない tar や zip アーカイブのファイル名としては
<literal>.phar</literal> は使用できないことに注意しましょう。
</para>
<para>
tar 形式の phar アーカイブの場合、デフォルトの拡張子は圧縮形式によって
<literal>.tar</literal>、<literal>.tar.gz</literal>、
<literal>.tar.bz2</literal> のいずれかとなります。
zip 形式のアーカイブの場合、デフォルトの拡張子は
<literal>.zip</literal> となります。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
このメソッドは、成功した場合に <classname>PharData</classname>
オブジェクトを返します。失敗した場合は &null; を返します。
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
圧縮ができない場合や無効な圧縮方式が指定された場合、あるいは
<function>Phar::startBuffering</function> でバッファリングしたまま
<function>Phar::stopBuffering</function> を実行していないアーカイブを処理しようとした場合に
<classname>BadMethodCallException</classname> をスローします。
また、phar 作成中に何らかの問題が発生した場合に
<classname>PharException</classname> をスローします。
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>format</parameter>、
<parameter>compression</parameter>、
<parameter>extension</parameter> は、nullable になりました。
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>PharData::convertToData</function> の例</title>
<para>
PharData::convertToData() の使用法です。
</para>
<programlisting role="php">
<![CDATA[
<?php
try {
$tarphar = new PharData('myphar.tar');
// myphar.tar は削除 *されない* ことに注意しましょう
// 実行可能ではない tar 形式に変換し
// myphar.zip を作成します
$zip = $tarphar->convertToData(Phar::ZIP);
// myphar.tbz を作成します
$tgz = $zip->convertToData(Phar::TAR, Phar::BZ2, '.tbz');
// myphar.phar.tgz を作成します
$phar = $tarphar->convertToData(Phar::PHAR); // throws exception
} catch (Exception $e) {
// ここでエラー処理をします
}
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>Phar::convertToExecutable</function></member>
<member><function>Phar::convertToData</function></member>
<member><function>PharData::convertToExecutable</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:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->