<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.operators.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ja',
  ),
  'this' => 
  array (
    0 => 'language.operators.errorcontrol.php',
    1 => 'エラー制御演算子',
    2 => 'エラー制御演算子',
  ),
  'up' => 
  array (
    0 => 'language.operators.php',
    1 => '演算子',
  ),
  'prev' => 
  array (
    0 => 'language.operators.comparison.php',
    1 => '比較演算子',
  ),
  'next' => 
  array (
    0 => 'language.operators.execution.php',
    1 => '実行演算子',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ja',
    'path' => 'language/operators/errorcontrol.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.operators.errorcontrol" class="sect1">
 <h2 class="title">エラー制御演算子</h2>
 
 <p class="simpara">
  PHP はエラー制御演算子(<code class="literal">@</code>)をサポートしています。
  PHP の式の前に付けた場合、
  その式により生成されたエラーメッセージは無視されます。
 </p>
 <p class="para">
  <span class="function"><a href="function.set-error-handler.php" class="function">set_error_handler()</a></span> で自作のエラーハンドラを設定した場合は
  エラー制御演算子があってもそのエラーハンドラがコールされます。
 </p>

 <div class="warning"><strong class="warning">警告</strong>
  <p class="para">
   PHP 8.0.0 より前のバージョンでは、
   エラー制御演算子(<code class="literal">@</code>)でエラーが無視されている場合、
   カスタムのエラーハンドラでコールされた
   <span class="function"><a href="function.error-reporting.php" class="function">error_reporting()</a></span> が常に <code class="literal">0</code> を返していました。
   PHP 8.0.0 以降では、以下の (ビット和の) 値を返すようになっています:
   <code class="literal">E_ERROR | E_CORE_ERROR | E_COMPILE_ERROR | E_USER_ERROR | E_RECOVERABLE_ERROR | E_PARSE</code>
  </p>
 </div>

 <p class="simpara">
  式によって生成されたあらゆるエラーメッセージは
  <span class="function"><a href="function.error-get-last.php" class="function">error_get_last()</a></span> 関数が返す配列要素
  <code class="literal">&quot;message&quot;</code> から取得できます。
  この関数の結果はエラーごとに変わります。よって速やかに確認する必要があります。
 </p>
 <p class="para">
  <div class="example" id="example-1">
   <p><strong>例1 意図的なエラー</strong></p>
   <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$my_file </span><span style="color: #007700">= @</span><span style="color: #0000BB">file </span><span style="color: #007700">(</span><span style="color: #DD0000">'non_existent_file'</span><span style="color: #007700">) or<br />    die (</span><span style="color: #DD0000">"Failed opening file: error was '" </span><span style="color: #007700">. </span><span style="color: #0000BB">error_get_last</span><span style="color: #007700">()[</span><span style="color: #DD0000">'message'</span><span style="color: #007700">] . </span><span style="color: #DD0000">"'"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </p>
 <p class="para">
  <div class="example" id="example-2">
   <p><strong>例2 式でのエラー抑制</strong></p>
   <div class="example-contents">
<div class="annotation-interactive cdata"><pre>
&lt;?php
// この演算子は関数だけでなく、全ての式で動作します。
$value = @$cache[$key]; 
// インデックス $key が存在しない場合でも、警告を発生しません。
?&gt;
</pre></div>
   </div>

  </div>
 </p>
 <blockquote class="note"><p><strong class="note">注意</strong>: 
  <span class="simpara">
   <code class="literal">@</code> 演算子は、
   <a href="language.expressions.php" class="link">式</a>
   に対してのみ動作します。基本的なルールは次のようになります。
   値を得ることができるものの場合、
   <code class="literal">@</code> 演算子を前に付けることが可能です。
   例えば、変数、関数、いくつかの言語構造(例: <span class="function"><a href="function.include.php" class="function">include</a></span>)
   のコールなどの前に、この演算子をつけることが可能です。
   関数またはクラスの定義、
   <code class="literal">if</code> や <a href="control-structures.foreach.php" class="link"><code class="literal">foreach</code></a> 等のような
   条件構造の前には、この演算子を付けることはできません。
  </span>
 </p></blockquote>
 <div class="warning"><strong class="warning">警告</strong>
  <p class="para">
   PHP 8.0.0 より前のバージョンでは、
   スクリプトの実行を停止させるような致命的な場合であっても
   <code class="literal">@</code> 演算子でエラーメッセージを抑止することが可能でした。
   たとえば、存在しなかったり、ミスタイプされていたり、
   利用できない関数コールの前に <code class="literal">@</code> 演算子を付けると、
   原因を示すことなく、その場所でスクリプトは終了してしまっていました。
  </p>
 </div>

 <div class="sect2">
  <h3 class="title">参考</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.error-reporting.php" class="function">error_reporting()</a></span></li>
    <li><a href="ref.errorfunc.php" class="link">エラーハンドリングとロギング関数</a></li>
   </ul>
  </p>
 </div>
</div><?php manual_footer($setup); ?>