PHP中国語マニュアル2-PHPチュートリアル-php.cn

PHP 中国語マニュアル 2

11. 例外処理

ユーザーは、PHP の組み込み例外処理クラスをカスタム例外処理クラスで拡張できます。次のコードは、組み込み例外処理クラスのどのプロパティとメソッドがサブクラスでアクセス可能で継承可能であるかを示しています。翻訳者注: 次のコードは、組み込みの例外処理クラスの構造を説明するためだけのものであり、実際的な意味を持つ使用可能なコードではありません。

<code>クラス例外{
protected $ message = '不明な例外'; //例外情報
保護 $code = 0; //ユーザー定義の例外コード
保護 $file //例外が発生したファイル名
保護$line ; // 例外が発生したコード行番号
function __construct($message = null, $code = 0);
final function getMessage(); // 例外メッセージを返します。 >final function getCode( ); // 例外コードを返します
final function getFile(); // 例外が発生したファイル名を返します
final function getLine(); // コード行番号を返します例外が発生した場所
final function getTrace(); // backtrace() 配列
final function getTraceAsString(); // getTrace() 情報を文字列にフォーマット
/* オーバーロード可能なメソッド*/
function __toString(); // 出力可能な文字列
}
?><code>class Exception{
protected $message = 'Unknown exception'; // 异常信息
protected $code = 0; // 用户自定义异常代码
protected $file; // 发生异常的文件名
protected $line; // 发生异常的代码行号
function __construct($message = null, $code = 0);
final function getMessage(); // 返回异常信息
final function getCode(); // 返回异常代码
final function getFile(); // 返回发生异常的文件名
final function getLine(); // 返回发生异常的代码行号
final function getTrace(); // backtrace() 数组
final function getTraceAsString(); // 已格成化成字符串的 getTrace() 信息
/* 可重载的方法 */
function __toString(); // 可输出的字符串
}
?>

カスタムクラスを使用して組み込みの例外処理クラスを拡張し、コンストラクターを再定義する場合は、同時にparent::__construct() を呼び出して、すべての変数が正しく設定されているかどうかを確認することをお勧めします。割り当てられた値。オブジェクトが文字列を出力したい場合は、__toString() をオーバーロードして出力スタイルをカスタマイズできます。

拡張 PHP 組み込み例外処理クラス

<code>// 例外処理クラスをカスタマイズします
class MyException extends Exception { // message が指定する必要があるプロパティになるようにコンストラクターを再定義します
public function __construct($message, $code = 0) {
// カスタマイズされたコード // すべての変数が正しい割り当てであることを確認します
parent ::__construct($message, $code);
}
// 文字列出力のスタイルをカスタマイズします
public function __toString() {
return __CLASS__ . ": [{$this->code}]: {$this->message}n";
}
public functioncustomFunction() {
echo "このカスタム関数例外の種類";
}
}
//<code>// 自定义一个异常处理类
class MyException extends Exception{ // 重定义构造器使 message 变为必须被指定的属性
public function __construct($message, $code = 0) {
// 自定义的代码 // 确保所有变量都被正确赋值
parent::__construct($message, $code);
}
// 自定义字符串输出的样式
public function __toString() {
return __CLASS__ . ": [{$this->code}]: {$this->message}n";
}
public function customFunction() {
echo "A Custom function for this type of exceptionn";
}
}
//创建一个用于测试异常处理机制的类
class TestException{
public $var;
const THROW_NONE = 0;
const THROW_CUSTOM = 1;
const THROW_DEFAULT = 2;
function __construct($avalue = self::THROW_NONE) {
switch ($avalue) {
case self::THROW_CUSTOM:
// 抛出自定义异常
throw new MyException('1 is an invalid parameter', 5);
break;
case self::THROW_DEFAULT:
// 抛出默认的异常
throw new Exception('2 isnt allowed as a parameter', 6);
break;
default:
// 没有异常的情况下，创建一个对象
$this->var = $avalue;
break;
}
}
}
// 例子 1
try {
$o = new TestException(TestException::THROW_CUSTOM);
} catch (MyException $e) { // 捕获异常
echo "Caught my exceptionn", $e;
$e->customFunction();
} catch (Exception $e) { // 被忽略
echo "Caught Default Exceptionn", $e;
}
// 执行后续代码
var_dump($o);
echo "nn";
// 例子 2
try {
$o = new TestException(TestException::THROW_DEFAULT);
} catch (MyException $e) { // 不能匹配异常的种类，被忽略
echo "Caught my exceptionn", $e;
$e->customFunction();
} catch (Exception $e) { // 捕获异常
echo "Caught Default Exceptionn", $e;
}
// 执行后续代码
var_dump($o);
echo "nn";
// 例子 3
try {
$o = new TestException(TestException::THROW_CUSTOM);
} catch (Exception $e) { // 捕获异常
echo "Default Exception caughtn", $e;
}
// 执行后续代码
var_dump($o);
echo "nn";
// 例子 4
try {
$o = new TestException();
} catch (Exception $e) { // 没有异常，被忽略
echo "Default Exception caughtn", $e;
}
// 执行后续代码
var_dump($o);
echo "nn";
?>例外処理メカニズムをテストするためのクラスを作成しますclass TestException{
public $var;
const THROW_NONE = 0;
const THROW_CUSTOM = 1;
const THROW_DEFAULT = 2;
function __construct($avalue = self:: THROW_NONE) {
switch ($avalue) {
case self::THROW_CUSTOM:
// カスタム例外をスローします
throw new MyException('1 は無効なパラメータです', 5 );
break;
case self::THROW_DEFAULT:
// デフォルトの例外をスローします
throw new Exception('2 はパラメータとして許可されません' , 6);
/>break;
default:
// 例外がない場合はオブジェクトを作成します
$this->var = $avalue;
break ;
}}
}
// 例 1
try {
$o = new TestException(TestException::THROW_CUSTOM);
} catch (MyException $e) { // 例外をキャッチ
echo "例外をキャッチしました", $e;
$e->customFunction();
} catch (Exception $e) { // 無視されました
>echo "Caught Default Exceptionn", $e;
}
// 後続のコードを実行します
var_dump($o);
echo "nn ";
//例 2
try {
$o = new TestException(TestException::THROW_DEFAULT);
} catch (MyException $e) { // 例外タイプに一致しません、無視されます
echo "例外をキャッチしました", $e;
$e->customFunction();
} catch (Exception $e) { // 例外をキャッチします
echo "デフォルトの例外をキャッチしました", $e ;
}
// 後続のコードを実行します
var_dump($o);
echo "nn";
// 例 3
try {
$o = new TestException(TestException::THROW_CUSTOM);
} catch (Exception $e) { // 例外をキャッチします
echo "Default Exception catchn" , $e;
}
// 後続のコードを実行します
var_dump($o);
echo "nn";
// 例 4
try {
$o = new TestException();
} catch (Exception $e) { // 例外なし、無視されます
echo "Default Exception catchn", $e;
}
// 後続のコードを実行します
var_dump($o);
echo "nn";
?>

12. ジェネレーター <code><code>

ジェネレーターを使用すると、foreach コードブロックにコードを書き込むことができます。メモリ内に配列を作成せずにデータのセットを反復処理すると、メモリの制限に達するか、かなりの処理時間がかかることになります。代わりに、通常のカスタム関数と同じようにジェネレーター関数を作成できます。通常の関数が 1 回だけ返すのではなく、ジェネレーターは反復する必要がある値を生成するために必要なだけ何度でも生成できます。

<code>function xrange($start, $limit, $step = 1) {
if ($start <$limit) {
if ($step <= 0) {
throw new LogicException('Step は ve でなければなりません');
}
Else {
if ($ Step & GT; = 0) {
新しい LogiceXception をスローします ('ステップは -ve である必要があります')
} for ($ i = $ start; $i > と xrange() は同じ結果になります。
* 以下の出力。 */
echo 'range() からの 1 桁の奇数: '; foreach (range(1, 9, 2) as $number) {
echo "$number ";
}
echo "n";
echo '1 桁xrange() からの奇数: ';
foreach (xrange(1, 9, 2) as $number) {
echo "$number ";
}
?> <code>function xrange($start, $limit, $step = 1) {
if ($start < $limit) {
if ($step <= 0) {
throw new LogicException('Step must be ve');
}
for ($i = $start; $i <= $limit; $i = $step) {
yield $i;
}
} else {
if ($step >= 0) {
throw new LogicException('Step must be -ve');
}
for ($i = $start; $i >= $limit; $i = $step) {
yield $i;
}
}
}
/* Note that both range() and xrange() result in the same
* output below. */
echo 'Single digit odd numbers from range(): ';
foreach (range(1, 9, 2) as $number) {
echo "$number ";
}
echo "n";
echo 'Single digit odd numbers from xrange(): ';
foreach (xrange(1, 9, 2) as $number) {
echo "$number ";
}
?>

Single digit odd numbers from range():  1 3 5 7 9 Single digit odd numbers from xrange(): 1 3 5 7 9

ログイン後にコピー

ジェネレーターと Iterator オブジェクトの比較

ジェネレーターの主な利点は、Iterator クラスを実装する場合に比べて、記述する必要のある定型コードがはるかに少なく、一般にコードが読みやすいことです。次の関数とクラスは同等です:

<code>function getLinesFromFile ($fileName) {
if (!$fileHandle = fopen($fileName, 'r')) {
return;
}
while (false !== $line = fgets($fileHandle)) {
yield $line ;
}
fclose($fileHandle);
}
// 対...
class LineIterator は Iterator {
protected $fileHandle;
protected $line;
protected $i;
public function __construct($fileName) {
if (!$this- >fileHandle = fopen($fileName, 'r')) {
新しいランタイム例外をスローします ('ファイル "'. $ FILENAME. '"')
}
Public function rewind () {
fseek($this->fileHandle, 0);
$this->line = fgets($this->fileHandle);
$this-> ;i = 0;
}
public function valid() {
return false !== $this->line;
}
public function current() {
return $this->line;
}
public function key() {
return $this->i;
}
public function next() {
if (false !== $this->line) {
$this->line = fgets($this->fileHandle);
$this ->i ;
}
}
パブリック関数 __destruct() {
fclose($this->fileHandle);
}
}?><code>function getLinesFromFile($fileName) {
if (!$fileHandle = fopen($fileName, 'r')) {
return;
}
while (false !== $line = fgets($fileHandle)) {
yield $line;
}
fclose($fileHandle);
}
// versus...
class LineIterator implements Iterator {
protected $fileHandle;
protected $line;
protected $i;
public function __construct($fileName) {
if (!$this->fileHandle = fopen($fileName, 'r')) {
throw new RuntimeException('Couldn't open file "' . $fileName . '"');
}
}
public function rewind() {
fseek($this->fileHandle, 0);
$this->line = fgets($this->fileHandle);
$this->i = 0;
}
public function valid() {
return false !== $this->line;
}
public function current() {
return $this->line;
}
public function key() {
return $this->i;
}
public function next() {
if (false !== $this->line) {
$this->line = fgets($this->fileHandle);
$this->i ;
}
}
public function __destruct() {
fclose($this->fileHandle);
}
}
?>

13. 引用<code><code>

<code>$a =& $b; // これは < を意味します。 🎜><code>$a =& $b; //这意味着 $a 和 $b 指向了同一个变量。$a 和 $b 在这里是完全相同的，这并不是 $a 指向了 $b 或者· //相反，而是 $a 和 $b 指向了同一个地方。
?>$a

と $b は同じ変数を指します。 <code>$a

と

はここではまったく同じですが、

$a は

$b または · // 代わりに、

$a および

$b は同じ場所を指します。
?>

<code>

if参照を持つ配列はコピーされ、その値は逆参照されません。配列値を関数に渡す場合も同様です。未定義の変数が参照によって割り当てられた場合、参照によって渡された場合、または参照によって返された場合、その変数は自動的に作成されます。

function foo(&$var) { }

foo ($a); // $a が「作成」され、null

$b = array();foo( $b['b']);

var_dump(array_key_exists('b', $b)); // bool(true)

$c = new StdClass;

<code>$bar =& new fooclass();
$foo =& find_var($bar);
?>foo($c->d);var_dump(property_exists($c, ' d')); // bool(true)

同じ構文参照を返す関数と new 演算子 (PHP 4.0.4 以降) で使用できます:

<code>

$bar =& new fooclass();
$foo =& find_var($ bar); ?>

<code>$var1 = "Example variable";
$var2 = "";
function global_references($use_globals){
global $var1, $var2;
if (!$use_globals) {
$var2 =& $var1; // visible only inside the function
} else {
$GLOBALS["var2"] =& $var1; // visible also in global context
}
}
global_references(false);
echo "var2 is set to '$var2'n"; // var2 is set to ''
global_references(true);
echo "var2 is set to '$var2'n"; // var2 is set to 'Example variable'
?>

参照は関数内で global として宣言された変数に割り当てられます。参照は関数内でのみ表示されます。これは、$GLOBALS 配列を使用することで回避できます。関数内でグローバル変数を参照する:

<code>

$var1 = "変数の例";
$var2 = "";
function global_references($use_globals){
global $var1, $var2;
if (!$use_globals) {
$var2 =& $var1; // 関数内でのみ表示されます
} else {
$GLOBALS["var2"] =& $ var1; // グローバルコンテキストでも表示されます
}
}
global_references(false);
echo "var2 is set to '$var2'n"; // var2 が設定されますto ''
global_references(true);
echo "var2 is set to '$var2'n"; // var2 は 'サンプル変数' に設定されます
?>

global $var;

を次のように扱います

$var =& $GLOBALS['var']; の略称です。したがって、他の参照を $var

に代入しても、ローカル変数の参照のみが変更されます。

参照を持つ変数に foreach ステートメントで値が割り当てられている場合参照されているオブジェクトも変更されます。

$ref = 0;

$row =& $ ref;

<code>function foo(&$var){
$var ;
}
$a=5;
foo($a);
?>foreach (array(1, 2, 3) as $row) {// 何かをする}echo $ref; // 3 - 反復配列の最後の要素

?>参照が行う 2 番目のことは、参照によって変数を渡すことです。これは、関数内にローカル変数を作成し、その変数が呼び出しスコープ内の同じコンテンツを参照することによって実現されます。例:

<code> function foo(&$var){
$var ;
}
$a=5;
foo($a);
?> は $a になります。これは、foo 関数の変数 $var が $a は同じコンテンツを指します。詳細な説明については、「参照による受け渡し」を参照してください。

参照が行う 3 番目のことは、参照を返すことです。参照はポインタではありません。

関数がその引数の値を変更できるように、参照によって変数を関数に渡すことができます。

<code><code>function foo(&$var){
$var ;
}
$a=5;
foo($a);// $a is 6 here
?>function foo( &$var){
$var ;
}
$a=5;
foo($a);// ここで $a は 6 です
?>

関数呼び出しには引用符がないことに注意してください。関数定義があります。パラメータを正しく参照渡しするには関数定義だけで十分です

以下は参照により渡すことができます:

変数 (foo($a) など); 新しいステートメント (foo(new foobar()) など) 関数から返される参照

その他の式は参照渡しできず、結果は未定義です。

関数バー( ){ // &
$a = 5;
return $a;
}
foo(bar()); // PHP 5.0.5 以降で発生エラー
foo($a = 5) // 式、変数ではありません
foo(5) // 致命的なエラーが発生します
?>

参照リターンは、関数を使用して参照をバインドする必要がある変数を見つけたい場合に使用します。。パフォーマンスを向上させるために戻り参照を使用しないでください

。エンジンはそれ自体を最適化するのに十分な機能を備えています。正当な技術的理由がある場合にのみ参照を返してください。参照を返すには、次の構文を使用します。

<code><?php class foo { public $value = 42; public function &getValue() { return $this->value; } } $obj = new foo; $myValue = &$obj->getValue(); // $myValue is a reference to $obj->value, which is 42. $obj->value = 2; echo $myValue; // prints the new value of $obj->value, i.e. 2. ?>

<code>< ? php クラス foo { public $value = 42; public function &getValue() { return $this->value; } } $obj = new foo; $myValue = &$obj->getValue(); // $myValue は $obj->value への参照であり、42 です。 $obj->value = 2; echo $myValue; // $obj->value の新しい値、つまり 2 を出力します。 ?>

この例では、getValue

関数はオブジェクトのプロパティは、参照構文が使用されていないかのように、コピーされずに割り当てられます。パラメーターの受け渡しとは異なり、ここでは両方の場所でアンパサンドを使用する必要があります。これは、通常のコピーではなく参照が返されることを示し、また $myValue が通常の代入ではなく参照としてバインドされていることを示します。参照の設定を解除すると、変数名と変数の内容の間のバインドが解除されるだけです。これは、変数の内容が破壊されることを意味するものではありません。

は設定を解除しません $b、

$a だけです。参照の配置:

グローバル参照:

global $var

で変数を宣言すると、グローバル変数への参照が実際に確立されます。これは次のことと同じです:

<code><?php $var =& $GLOBALS["var"]; //这意味着，例如，unset <var><var>$var</var></var> 不会 unset 全局变量。 ?>

$this: オブジェクトのメソッド内、

$this

は常に、それを呼び出すオブジェクトへの参照です。

14. 事前定義変数

スーパーグローバル変数変数は、すべてのスコープで常に使用できる組み込み変数です。PHP の定義済み変数の多くは「スーパーグローバル」です。これは、スクリプトのすべてのスコープで使用できることを意味します。

global $variable;

を実行せずに、関数またはメソッド内でアクセスできます。これらのスーパーグローバル変数は次のとおりです。 $_COOKIE;$_SESSION;$_REQUEST;$_ENV

デフォルトでは、すべてのスーパーグローバル変数が使用可能です。ただし、この可用性に影響を与えるディレクティブがいくつかあります。

$GLOBALS — グローバルスコープで使用可能なすべての変数を参照します。1 つはすべての変数を含みます。 . グローバル組み合わせ配列。変数の名前は配列のキーです。

<code><code>function test() {
$foo = "local variable";
echo '$foo in global scope: ' . $GLOBALS["foo"] . "n";//$foo in global scope: Example content
echo '$foo in current scope: ' . $foo . "n";//$foo in current scope: local variable
}
$foo = "Example content";
test();
?>関数 test() {
$foo = "ローカル変数";
エコー '$foo をグローバルスコープで: ' . $GLOBALS["foo"] .グローバルスコープ内: 内容の例
echo '現在のスコープ内の $foo : ' $foo . "n";// 現在のスコープ内の $foo : ローカル変数
}
$foo = "コンテンツの例";
test();
?>

「スーパーグローバル」は自動グローバル変数とも呼ばれます。これは、スクリプトのすべてのスコープで使用できることを意味します。関数やメソッドで global $variable; を使用してアクセスする必要はありません。他のすべてのスーパーグローバル変数とは異なり、$GLOBALS は PHP で常に使用できます。

$_SERVERヘッダー情報（header）、パス（path）、スクリプトの場所（script location）などの情報を含む配列です。この配列内の項目は、>

Web サーバーの作成によって表されます。 $_SERVER で次の要素が見つかる場合と見つからない場合があります。列挙:

'PHP_SELF': 現在のドキュメントルートに関連する実行スクリプト名。たとえば、http://example.com/test.php/foo.bar のスクリプトで

$_SERVER['PHP_SELF'] は /test.php/foo.bar を取得します。

'SERVER_ADDR': 現在実行中のスクリプトが存在するサーバーの IP アドレス。

'SERVER_NAME': 現在実行中のスクリプトが存在するサーバーのホスト名。スクリプトが仮想ホスト上で実行されている場合、名前はその仮想ホストに設定された値によって決まります。

'SERVER_PROTOCOL': リクエスト時に通信します。ページプロトコルの名前とバージョン。たとえば、「HTTP/1.0」です。

'REQUEST_METHOD': にアクセスするために使用されます。ページのリクエストメソッド。たとえば、「GET」、「HEAD」、「POST」、「PUT」。

'REQUEST_TIME': リクエスト開始時のタイムスタンプ。 PHP 5.1.0 以降で利用可能です。

'QUERY_STRING': クエリ文字列 String) 、存在する場合、それを通じてページアクセスが実行されます。

'HTTP_HOST': 現在のリクエスト内header Host: 項目の内容 (存在する場合)。

'HTTP_REFERER': ユーザーエージェントを現在のページの前のページのアドレス (存在する場合) に誘導します。ユーザーエージェント設定によって決定されます。すべてのユーザーエージェントがこの項目を設定するわけではなく、一部のユーザーエージェントは HTTP_REFERER を変更する機能も提供します。要するに、その値は信頼できません。

'HTTP_USER_AGENT': 現在のリクエスト内header User-Agent: 項目の内容 (存在する場合)。この文字列は、このページにアクセスするユーザーエージェントに関する情報を示します。

'REMOTE_ADDR': 現在のページを参照しますユーザーの IP アドレス。

'REMOTE_HOST': 現在のページを閲覧しているユーザーのホスト名。 DNS 逆引き解決は、ユーザーの REMOTE_ADDR には依存しません。

'SERVER_PORT': Web によって使用されますサーバーポート。デフォルト値は「80」です。 SSL セキュア接続を使用する場合、この値はユーザーが設定した HTTP ポートです。

$_GET: URL パラメーターを介して現在のスクリプトに渡される変数の配列。 GET は urldecode() 経由で渡されます。

$_POST: HTTP POST メソッドを通じて現在のスクリプトに渡される変数配列。 $_FILES : HTTP POST 経由で現在のスクリプトにアップロードされた項目の配列。

$_REQUEST — HTTP リクエスト変数は、コマンドラインモードで実行すると、存在する argv および argc 情報を 含みません 。 $_SERVER 配列。

$_REQUEST の変数は GET、POST、COOKIE 入力メカニズムを通じてスクリプトファイルに渡されるため、リモートユーザーによって改ざんされる可能性があり、信頼できません。この配列の項目とその順序は、PHP の variables_order ディレクティブの構成によって異なります。

$_SESSION: 現在のスクリプトで使用できる SESSION 変数の配列。

move_uploaded_file() - アップロードされたファイルを新しい場所に移動します。 import_request_variables() - GET/POST/Cookie 変数をグローバルスコープにインポートします。 session_start() - 新しいセッションを開始するか、既存のセッションを再利用します。

$_ENV: 環境を通じて現在のスクリプトに渡される変数の配列。これらの変数は、PHP パーサーのランタイム環境から PHP のグローバル名前空間にインポートされます。多くは PHP の実行をサポートするシェルによって提供されており、異なるシステムでは異なる種類のシェルが実行される可能性があるため、明確なリストは不可能です。定義された環境変数のリストについては、シェルのドキュメントを確認してください。他の環境変数には、PHP がサーバーモジュールとして実行されているか CGI プロセッサとして実行されているかに関係なく、CGI 変数が含まれます。

$_COOKIE: HTTP Cookie 配列を通じて現在のスクリプトに渡される変数。 setcookie() - Cookie を送信します

$php_errormsg — 前のエラーメッセージ; $php_errormsg 変数には、PHP によって生成された最新のエラーメッセージが含まれます。この変数は、エラーが発生したスコープ内でのみ使用でき、track_errors 構成項目をオンにする必要があります (デフォルトはオフです)。ユーザーがエラーハンドラー (set_error_handler()) を定義し、<code>FALSE を返す場合、$php_errormsg が設定されます。

<code><code>@strpos();
echo $php_errormsg; //Wrong parameter count for strpos()
?>@strpos();
echo $php_errormsg; //strpos() のパラメータ数が間違っています
?>

$HTTP_RAW_POST_DATA — ネイティブ POST データ。 $HTTP_RAW_POST_DATA POST によって送信された生データが含まれます。 always_populate_raw_post_data を参照してください。通常、$HTTP_RAW_POST_DATA の代わりに php://input を使用します。

$http_response_header — HTTP 応答ヘッダー: $ http_response_header 配列は get_headers() 関数に似ています。 HTTP ラッパーを使用する場合、$http_response_header に HTTP 応答ヘッダーが設定されます。 $http_response_header はローカルスコープに作成されます。

function get_contents() {
file_get_contents("http://example.com");
var_dump($http_response_header);
}
get_contents();
/> />var_dump($http_response_header);
?>

$argc — スクリプトに渡される引数の数: コマンドラインから実行するときに現在のスクリプトに渡される引数の数が含まれます。スクリプトのファイル名は常に引数として現在のスクリプトに渡されるため、$argc の最小値は 1

です。この変数は、 register_argc_argv がオンになっている場合にのみ使用できます。

$argv — スクリプトに渡される引数 配列 : コマンドラインから実行するときに現在のスクリプトに渡されるパラメーターを含む配列。最初のパラメータは常に現在のスクリプトのファイル名であるため、$argv[0]

がスクリプトファイル名になります。この変数は、 register_argc_argv がオンになっている場合にのみ使用できます。

15. 事前定義された例外

Exception

は、すべての例外の基本クラスです。クラスの概要:

Exception {

/* 属性 */

protectedstring$message ;

protectedint$code ;

protectedstring$file ;

protectedint$line ;

/* 方法 */

public__construct ([ string<code>$message = "" [, int<code>$code = 0 [, Exception<code>$previous = <code>NULL ]]] )

finalpublicstringgetMessage ( void )

finalpublicExceptiongetPrevious ( void )

finalpublicintgetCode ( void )

finalpublicstringgetFile ( void )

finalpublicintgetLine ( void )

finalpublicarraygetTrace ( void )

finalpublicstringgetTraceAsString ( void )

publicstring__toString ( void )

finalprivatevoid__clone ( void )

}属性：message：异常消息内容；code：异常代码；file：抛出异常的文件名；line：抛出异常在该文件中的行号

Exception::__construct — 异常构造函数

参数：message：抛出的异常消息内容。code：异常代码。previous：异常链中的前一个异常。

Exception::getMessage — 获取异常消息内容

参数：此函数没有参数。

Exception::getPrevious — 返回异常链中的前一个异常

参数：Exception::getPrevious — 返回异常链中的前一个异常。追踪异常，并循环打印。

<code><?php class MyCustomException extends Exception {} function doStuff() { try { throw new InvalidArgumentException("You are doing it wrong!", 112); } catch(Exception $e) { throw new MyCustomException("Something happend", 911, $e); } } try { doStuff(); } catch(Exception $e) { do { printf("%s:%d %s (%d) [%s]\n", $e->getFile(), $e->getLine(), $e->getMessage(), $e- >getCode(), get_class($e)); } while($e = $e->getPrevious()); } ?>

以上例程的输出类似于：

<span style="font-size: large;">/home/bjori/ex.php:8 Something happend (911) [MyCustomException]/home/bjori/ex.php:6 You are doing it wrong! (112) [InvalidArgumentException]</span>

ログイン後にコピー

Exception::getCode — 获取异常代码

参数：此函数没有参数。

Exception::getFile — 获取发生异常的程序文件名称

参数：此函数没有参数。

Exception::getLine — 获取发生异常的代码在文件中的行号

参数：此函数没有参数。

Exception::getTrace — 例外トレース情報を取得する

パラメータ: この関数にはパラメータがありません。

Exception::getTraceAsString — 文字列型

パラメータ: この関数にはパラメータがありません。

Exception::__toString — 例外オブジェクトを文字列に変換する

パラメータ: この関数にはパラメータがありません。

Exception::__clone — 例外クローン

パラメータ: この関数にはパラメータがありません。戻り値はなく、例外を複製することはできません。

ErrorException::__construct — 例外コンストラクター

パラメータ: message: スローされた例外メッセージの内容。コード: 例外コード。 severity: 例外の重大度レベル。 filename: 例外がスローされたファイル名。 lineno: 例外がスローされた行番号。前: 例外チェーン内の前の例外。

ErrorException::getSeverity — 例外の重大度を取得します

パラメータ: この関数にはパラメータがありません。

<code>

試してください {
throw new ErrorException("例外メッセージ", 0, 75);
} catch(ErrorException $e) {
echo "この例外の重大度は次のとおりです: $e->getSeverity();
/>}
?><code>try {
throw new ErrorException("Exception message", 0, 75);
} catch(ErrorException $e) {
echo "This exception severity is: " . $e->getSeverity();
}
?>

16. 定義済みインターフェース

トラバース可能なインターフェース:

を検出するインターフェースforeach を使用してクラスを横断できるかどうか。単独では実装できない基本的な抽象インターフェイス。代わりに、

IteratorAggregate または Iterator インターフェイスによって実装する必要があります。このインターフェイスを実装する組み込みクラスは、IteratorAggregate または Iterator インターフェイスを実装せずに、反復に foreach を使用できます。これは、PHP スクリプトでは実装できない内部エンジンインターフェイスです。代わりに、IteratorAggregate または Iterator インターフェイスを使用できます。

Traversable { } このインターフェースこれにはメソッドはなく、すべての走査可能なクラスの基本インターフェイスとして機能するだけです。

反復子インターフェイス:

独自の外部イテレータまたはクラスを介して内部的に反復できるインターフェイス。

イテレータextendsTraversable {

/* Method*/

abstractpublicmixedcurrent (void)

abstractpublicscalarkey (void)

abstractpublicvoidnext (void)

abstractpublicvoidrewind (void)

abstractpublicbooleanvalid ( void )

}

Iterator::current — 現在の要素を返します。パラメータはなく、任意の型を返すことができます。

Iterator::key — 現在の要素のキーを返す: noパラメータ。成功した場合はスカラーを返し、失敗した場合は null を返します。

Iterator::next — 次の要素に進みます。引数がない場合、戻り値は無視されます。このメソッドは、foreach ループ

の後にと呼ばれます。

Iterator::rewind — 返回到迭代器的第一个元素：当开始一个 foreach 循环时，这是第一个被调用的方法。它将不会在 foreach 循环之后被调用。没有参数，任何返回都将被忽略。

Iterator::valid — 检查当前位置是否有效：此方法在 Iterator::rewind() 和 Iterator::next() 方法之后被调用以此用来检查当前位置是否有效。没有参数，返回将被转换为布尔型。成功时返回 <code>TRUE，或者在失败时返回 <code>FALSE。

IteratorAggregate::getIterator — 获取一个外部迭代器：没有参数，实现了 Iterator 或 Traversable 接口的类的一个实例。

ArrayAccess（数组式访问）接口：

提供像访问数组一样访问对象的能力的接口。

ArrayAccess {

/* 方法 */

abstractpublicbooleanoffsetExists ( mixed<code>$offset )

abstractpublicmixedoffsetGet ( mixed<code>$offset )

abstractpublicvoidoffsetSet ( mixed<code>$offset , mixed<code>$value )

abstractpublicvoidoffsetUnset ( mixed<code>$offset )

}

ArrayAccess::offsetExists — 检查一个偏移位置是否存在：对一个实现了 ArrayAccess 接口的对象使用 isset() 或 empty() 时，此方法将执行。当使用 empty() 并且仅当 ArrayAccess::offsetExists() 返回 <code>TRUE 时，ArrayAccess::offsetGet() 将被调用以检查是为否空。参数：offset 需要检查的偏移位置。成功时返回 <code>TRUE，或者在失败时返回 <code>FALSE。如果一个非布尔型返回值被返回，将被转换为布尔型。

以上例程的输出类似于：

<span style="font-size: large;">Runs obj::offsetExists()string(17) "obj::offsetExists"bool(true)Runs obj::offsetExists() and obj::offsetGet()string(17) "obj::offsetExists"string(14) "obj::offsetGet"bool(false)Runs obj::offsetExists(), *not* obj:offsetGet() as there is nothing to getstring(17) "obj::offsetExists"bool(true)</span>

ログイン後にコピー

ArrayAccess::offsetGet — 获取一个偏移位置的值：当检查一个偏移位置是否为 empty() 时，此方法被执行。

参数：offset 需要获取的偏移位置。返回值：可返回任何类型。

ArrayAccess::offsetSet — 设置一个偏移位置的值：参数：offset 待设置的偏移位置。value 需要设置的值。没有返回值。

別の値が使用できない場合、<code>offset パラメータは <code>NULL。

に設定されます。

ArrayAccess::offsetUnset — オフセット位置の値をリセットする: 型変換に使用 (未設定) する場合、このメソッドは呼び出されません。

<code>参数：offset リセットするオフセット位置。戻り値はありません。

シリアル化インターフェイス:

シリアル化可能: :serialize — オブジェクトの文字列表現。このメソッドはオブジェクトデストラクターの役割を果たします。このメソッドの後、 __destruct() メソッドは ではなく 呼び出されます。この関数にはパラメータがなく、戻り値は返されたオブジェクトの文字列表現、または <code>NULL です。

Serializable::unserialize — オブジェクトを構築します。このメソッドはオブジェクトコンストラクターの役割を果たします。このメソッドの後、__construct() は ではなく 呼び出されます。パラメータ: シリアル化されたオブジェクトの文字列表現。

Closure::__construct — インスタンス化を禁止するために使用されるコンストラクター。このメソッドは、Closure クラスのオブジェクトのインスタンス化を無効にするためにのみ使用されます。このクラスのオブジェクトの作成方法は匿名関数のページに書かれています。この関数にはパラメータも戻り値もありません。

Closure::bind — クロージャをコピーし、指定された $this オブジェクトをクラススコープにバインドします。このメソッドは Closure::bindTo() の静的バージョンです。

パラメータ:クロージャバインドする必要がある匿名関数。 newthis には、匿名関数にバインドされたオブジェクトが必要です。そうでない場合、<code>NULL は非バインドクロージャを作成します。 newscope は、クロージャにバインドするクラススコープです。または、「static」は変更されていないことを意味します。オブジェクトが渡された場合は、オブジェクトの型名が使用されます。クラススコープは、クロージャ内の $this オブジェクトのプライベートな保護されたメソッドの可視性を決定するために使用されます。新しい Closure オブジェクト、または失敗時に返します <code>FALSE

<code><code>class A {
private static $sfoo = 1;
private $ifoo = 2;
}
$cl1 = static function() {
return A::$sfoo;
};
$cl2 = function() {
return $this->ifoo;
};
$bcl1 = Closure::bind($cl1, null, 'A');
$bcl2 = Closure::bind($cl2, new A(), 'A');
echo $bcl1(), "n"; //1
echo $bcl2(), "n"; //2
?>クラス A {
private static $sfoo = 1;
private $ifoo = 2;
} $cl1 = static function() {
return A::$sfoo;
};
$cl2 = function() {
return $this->ifoo ;
/>};
$bcl1 = Closure::bind($cl1, null, 'A');
$bcl2 = Closure::bind($cl2, new A(), ' A') ;
echo $bcl1(), "n"; //1
echo $bcl2(), "n";
?>

code>

Closure::bindTo — 現在のクロージャオブジェクトをコピーし、バインドする指定された $this オブジェクトとクラススコープ。匿名関数を作成して返します。この関数は、現在のオブジェクトと同じ関数本体を持ち、同じ変数をバインドしますが、異なるオブジェクトまたは新しいクラススコープをバインドできます。「バインドされたオブジェクト」は関数本体の $this<code>newscope の値を決定し、「クラススコープ」は型を表し、この匿名関数でどのプライベートメソッドと保護されたメソッドを呼び出すことができるかを決定します。つまり、この時点で $this が呼び出せるメソッドは、<code>newthis クラスのメンバー関数と同じになります。静的クロージャはバインドされたオブジェクトを持つことができません ( パラメータの値は <code>NULL に設定する必要があります) が、クラススコープは bubdTo メソッドを使用して変更できます。匿名関数をコピーしたいだけの場合は、代わりにクローン作成を使用できます。

パラメータ: newthis 無名関数にバインドされたオブジェクト、またはバインドを解除する <code>NULL。 newscope は匿名関数のクラススコープに関連付けられます。または、「static」は現在の状態を維持します。それがオブジェクトの場合、このオブジェクトのタイプはエクスペリエンスクラスのスコープで使用されます。これにより、バインドされたオブジェクトの保護されたプライベートメンバーメソッドの可視性が決まります。戻り値: 新しく作成された Closure オブジェクト、または失敗時に返されます <code>FALSE

<code><?php class A { function __construct($val) { $this->val = $val; } function getClosure() { //returns closure bound to this object and scope return function() { return $this->val; }; } } $ob1 = new A(1); $ob2 = new A(2); $cl = $ob1->getClosure(); echo $cl(), "n"; //1 $cl = $cl->bindTo($ob2); echo $cl(), "n"; //2 ?>

17. コンテキストオプションとパラメータ

ソケットコンテキストオプションすべてを使用できますtcp、http、ftp など、ソケット上で動作するラッパープロトコル。

<code><code>// connect to the internet using the '192.168.0.100' IP
$opts = array(
'socket' => array(
'bindto' => '192.168.0.100:0',
),
);
// connect to the internet using the '192.168.0.100' IP and port '7000'
$opts = array(
'socket' => array(
'bindto' => '192.168.0.100:7000',
),
);
// connect to the internet using port '7000'
$opts = array(
'socket' => array(
'bindto' => '0:7000',
),
);
// create the context...
$context = stream_context_create($opts);
// ...and use it to fetch the data
echo file_get_contents('http://www.example.com', false, $context);
?>// '192.168' IP を使用してインターネットに接続します $opts = array(
'socket' => array(
'bindto' => '192.168.0.100:0',
),
);
// IP '192.168.0.100' とポート '7000' を使用してインターネットに接続します
$opts = array(
'socket' => array(
/> 'bindto' => '192.168.0.100:7000',
),
);
// ポート '7000' を使用してインターネットに接続します
$opts = array(
'socket' => array(
'bindto' => '0:7000',
),
);
// コンテキストを作成します。 ..
$context = stream_context_create($opts);
// ...それを使用してデータを取得します
echo file_get_contents('http://www.example.com ', false, $context);
?>

HTTP コンテキストオプション — HTTP コンテキストのオプションのリスト。 http:// および https:// トランスポートプロトコルに提供されるコンテキストオプション。トランスポートのオプション:

<code>methodstring リモートサーバーは <code>GET、<code>POST などをサポートします。 HTTPメソッド。デフォルト値は <code>GET です。
<code>headerstring リクエスト中に送信される追加のヘッダー。このオプションの値は、他の値 (User-agent:、Host:、Authentication: など) をオーバーライドします。
<code>user_agent文字列送信されるヘッダー User-Agent: の値。上記の header コンテキストオプションでユーザーエージェントが指定されていない場合は、この値が使用されます。デフォルトでは、php.ini で設定された user_agent が使用されます。
<code>contentstring ヘッダーの後に送信される追加データ。通常は、POST リクエストまたは PUT リクエストを使用します。
<code>proxy文字列 URI 指定されたプロキシサーバーのアドレス。 (例: tcp://proxy.example.com:5100)。
<code>request_fulluriブール値 <code>TRUE に設定されている場合、リクエストの作成時に URI 全体が使用されます。 (つまり、GET http://www.example.com/path/to/file.html HTTP/1.0)。これは非標準のリクエスト形式ですが、一部のプロキシサーバーではこれが必要です。デフォルト値は <code>FALSE です。
<code>follow_location整数は、Location ヘッダーのリダイレクトの後に続きます。無効にするには、0 に設定します。デフォルト値は 1 です。
<code>max_redirects整数従うリダイレクトの最大数。 1 以下の値は、リダイレクトが行われないことを意味します。デフォルト値は 20 です。
<code>protocol_versionfloat HTTP プロトコルのバージョン。デフォルト値は 1.0 です。 PHP 5.3.0 より前のバージョンでは、チャンク転送デコードが実装されていませんでした。この値が 1.1 に設定されている場合、 1.1 との互換性はユーザーの責任になります。
<code>timeoutfloat 読み取りタイムアウト (秒単位)、float で指定します (例: 10.5)。デフォルトでは、php.ini で設定されたdefault_socket_timeout が使用されます。
<code>ignore_errorsboolean は、障害ステータスコードがある場合でもコンテンツを取得します。デフォルト値は <code>FALSE です。

FTP コンテキストオプション — FTP コンテキストオプションのリスト

SSL コンテキストオプション — SSL コンテキストオプションのリスト。 ssl:// および tls:// トランスポートプロトコルコンテキストオプションのリスト。オプション: 多数。

CURL コンテキストオプション — CURL コンテキストオプションのリスト。 CURL コンテキストオプションは、CURL 拡張機能がコンパイルされるときに使用できます (--with-curlwrappers 構成オプション経由)。オプションのオプション:

<code>method文字列 <code>GET、<code>POST、またはその他のリモートサーバーのサポートHTTPメソッド。デフォルトは <code>GET.
<code>headerstring 追加のリクエストヘッダー。この値は、他のオプション (User-agent:、Host:、、Authentication: など) で設定された値をオーバーライドします。
<code>user_agentstring リクエストの User-Agent ヘッダーの値を設定します。デフォルトは、php.ini の user_agent 設定です。
<code>contentstring ヘッダーの後に送信される追加データ。このオプションは、<code>GET および <code>HEAD リクエストでは使用されません。
<code>proxy文字列 URI。プロキシサーバーのアドレスを指定するために使用されます (例: tcp://proxy.example.com:5100)。
<code>max_redirects整数リダイレクトの最大数。 1 以下は、リダイレクトが従わないことを意味します。デフォルトは 20.
<code>curl_verify_ssl_hostブール検証サーバーです。デフォルトは <code>FALSE。 です。このオプションは HTTP プロトコルと FTP プロトコルの両方で使用できます。
<code>curl_verify_ssl_peerboolean 使用される SSL 証明書の検証が必要です。デフォルトは <code>FALSE。 です。このオプションは HTTP プロトコルと FTP プロトコルの両方で使用できます。ページを取得し、POST としてデータを送信します:

<code><code>$postdata = http_build_query(
array(
'var1' => 'some content',
'var2' => 'doh'
)
);
$opts = array('http' =>
array(
'method' => 'POST',
'header' => 'Content-type: application/x-www-form-urlencoded',
'content' => $postdata
)
);
$context = stream_context_create($opts);
$result = file_get_contents('http://example.com/submit.php', false, $context);
?>$postdata = http_build_query(
array(
) ' var1' => '一部のコンテンツ',
'var2' => 'doh'
) )
);
$opts = array('http' => array(
'method' => 'POST',
'header' => 'Content-type: application/x-www-form-urlencoded',
' content' => $postdata
)
);
$context = stream_context_create($opts);
$result = file_get_contents('http://example.com/ submit .php', false, $context);
?>

Phar コンテキストオプション — Phar コンテキストオプションのリスト。 phar://<code>compress ラッパーのコンテキストオプション。オプション: <code>metadataint Phar 圧縮定数の 1 つ。混合 Phar メタデータ。 Phar::setMetadata() を参照してください。

コンテキストパラメーター — コンテキストパラメーターのリスト。これらのパラメータ (parameters) は、関数 stream_context_set_params() によって返される context<code>notification に設定できます。パラメータ: callable ストリーム上でイベントが発生すると、callable が呼び出されます。

18. サポートされるプロトコルとカプセル化プロトコル

file:// — ローカルファイルシステムにアクセスします。 Filesystem は、PHP で使用されるデフォルトのラッパープロトコルであり、ローカルファイルシステムを公開します。相対パス (/、、、\、または Windows ドライブ文字で始まらないパス) が指定された場合、指定されるパスは現在の作業ディレクトリに基づきます。多くの場合、変更されていない限り、これはスクリプトが存在するディレクトリです。 CLI を使用する場合、ディレクトリはデフォルトでスクリプトが呼び出されるディレクトリになります。

fopen() や file_get_contents() などの特定の関数では、include_path もオプションで検索されます。相対パス。

**封装协议概要**
属性	支持
受 allow_url_fopen 影响	No
允许读取	Yes
允许写入	Yes
允许添加	Yes
允许同时读和写	Yes
支持 stat()	Yes
支持 unlink()	Yes
支持 rename()	Yes
支持 mkdir()	Yes
支持 rmdir()	Yes

http:// -- https:// — HTTP URL にアクセスします。 HTTP 1.0 GET メソッドを介したファイルまたはリソースへの読み取り専用アクセスを許可します。 HTTP リクエストには、ドメイン名ベースの仮想ホストとの互換性を確保するために Host: ヘッダーが伴います。 user_agent 文字列が php.ini ファイルまたはバイトストリームコンテキストで設定されている場合、それもリクエストに含まれます。データストリームではリソースの body を読み取ることができ、ヘッダーは $http_response_header 変数に保存されます。

ドキュメントリソースの送信元の URL を知る必要がある場合 (すべてのリダイレクトを処理した後)、返された一連の応答ヘッダーを処理する必要があります。データフロー (応答ヘッダー) によって異なります。

**封装协议概要**
属性	支持
受 allow_url_fopen 限制	Yes
允许读取	Yes
允许写入	No
允许添加	No
允许同时读和写	N/A
支持 stat()	No
支持 unlink()	No
支持 rename()	No
支持 mkdir()	No
支持 rmdir()	No

封装协议概要
属性支持

受 allow_url_fopen 限制 Yes

允许读取 Yes

允许写入 No

允许添加 No

允许同时读和写 N/A

支持 stat() No

支持 unlink() No

支持 rename() No

支持 mkdir() No

支持 rmdir() No

パッケージングプロトコルの概要属性サポートされています allow_url_fopen によって制限されていますはい読み取りを許可しますはい書き込みを許可しますいいえ許可追加いいえ同時読み取りと書き込みを許可します該当なしサポート stat() いいえ unlink() をサポートしますいいえ rename() のサポートいいえ mkdir() のサポートいいえ rmdir() をサポートしますいいえ

ftp:// -- ftps:// — FTP URL にアクセスします。新しいファイルを作成するだけでなく、FTP 経由で既存のファイルを読み取ることもできます。サーバーがパッシブモード FTP をサポートしていない場合、接続は失敗します。

ファイルを開いた後は、読み取りと書き込みの両方が可能ですが、同時にはできません。リモートファイルが FTP サーバー上にすでに存在する場合、コンテキストオプション overwrite を指定せずにファイルを開いて書き込もうとすると、接続は失敗します。 FTP 経由で既存のファイルを上書きする場合は、開いて書き込むコンテキストの overwrite オプションを指定します。代わりに、FTP 拡張機能を使用することもできます。 php.ini で from ディレクティブを設定すると、この値は匿名 FTP のパスワードとして使用されます。

の追加を許可します

**カプセル化プロトコルの概要**
属性	PHP 4	PHP 5
allow_url_fopen の影響を受ける	はい	はい
読み取りを許可します	はい	はい
書き込みを許可します	はい (新しいファイルのみ)	はい (新しいファイル/<code>overwrite を有効にした後に既に存在するファイル)
	いいえ	はい
同時読み取りと書き込みを許可します	いいえ	いいえ
サポート stat()