<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/migration81.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ja',
  ),
  'this' => 
  array (
    0 => 'migration81.deprecated.php',
    1 => 'PHP 8.1.x で推奨されなくなる機能',
    2 => 'PHP 8.1.x で推奨されなくなる機能',
  ),
  'up' => 
  array (
    0 => 'migration81.php',
    1 => 'PHP 8.0.x から PHP 8.1.x への移行',
  ),
  'prev' => 
  array (
    0 => 'migration81.incompatible.php',
    1 => '下位互換性のない変更点',
  ),
  'next' => 
  array (
    0 => 'migration81.other-changes.php',
    1 => 'その他の変更',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ja',
    'path' => 'appendices/migration81/deprecated.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="migration81.deprecated" class="sect1">
 <h2 class="title">PHP 8.1.x で推奨されなくなる機能</h2>

 <div class="sect2" id="migration81.deprecated.core">
  <h3 class="title">PHP コア</h3>

  <div class="sect3" id="migration81.deprecated.core.serialize-interface">
   <h4 class="title">
    <span class="function"><strong>__serialize()</strong></span>,
    <span class="function"><strong>__unserialize()</strong></span> がない状態で、
    <span class="interfacename"><a href="class.serializable.php" class="interfacename">Serializable</a></span> を実装するのは推奨されない
   </h4>

   <p class="para">
    新しいこれらのメソッドだけを実装するか、
    これらのメソッドをサポートしていない
    PHP 7.4 より前のバージョンでも使う場合は、
    新旧両方のインターフェイスを実装すべきです。
   </p>
  </div>

  <div class="sect3" id="migration81.deprecated.core.null-not-nullable-internal">
   <h4 class="title">ビルトイン関数の nullable でない引数に <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> を渡した場合</h4>

   <p class="para">
    ビルトイン関数のスカラー型の引数は、
    デフォルトで nullable ですが、
    この振る舞いは推奨されなくなりました。
    ユーザ定義の関数においては、
    スカラー型の引数は nullable と明示的にマークする必要があり、
    その振る舞いと合わせるためです。

    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">str_contains</span><span style="color: #007700">(</span><span style="color: #DD0000">"foobar"</span><span style="color: #007700">, </span><span style="color: #0000BB">null</span><span style="color: #007700">));<br /></span><span style="color: #FF8000">// Deprecated: Passing null to parameter #2 ($needle) of type string<br />//             is deprecated<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>
  </div>

  <div class="sect3" id="migration81.deprecated.core.implicit-float-conversion">
   <h4 class="title">暗黙の <span class="type"><a href="language.types.float.php" class="type float">float</a></span> から <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> への変換</h4>

   <p class="para">
    精度を損なうことになる
    <span class="type"><a href="language.types.float.php" class="type float">float</a></span> から <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> への暗黙の変換は、
    推奨されなくなりました。
    これは配列のキーに <span class="type"><a href="language.types.float.php" class="type float">float</a></span> を使った場合や、
    型の自動変換 (coerciveモード) 時に <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> 型を宣言した場合や、
    <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> に対して演算子を適用する場合に影響します。
    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$a </span><span style="color: #007700">= [];<br /></span><span style="color: #0000BB">$a</span><span style="color: #007700">[</span><span style="color: #0000BB">15.5</span><span style="color: #007700">]; </span><span style="color: #FF8000">// 推奨されません。0.5 がキーの値から失われるからです<br /></span><span style="color: #0000BB">$a</span><span style="color: #007700">[</span><span style="color: #0000BB">15.0</span><span style="color: #007700">]; </span><span style="color: #FF8000">// 15.0 == 15 なので OK<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>
  </div>

  <div class="sect3" id="migration81.deprecated.core.static-trait">
   <h4 class="title">トレイトの <span class="modifier">static</span> な要素をコールする</h4>

   <p class="para">
    トレイトにある
    <span class="modifier">static</span> メソッドや、
    <span class="modifier">static</span> プロパティに直接アクセスすることは、
    推奨されなくなりました。
    これらは、トレイトを使っているクラスからのみアクセスすべきものです。
   </p>
  </div>

  <div class="sect3" id="migration81.deprecated.core.magic-sleep">
   <h4 class="title"><span class="function"><strong>__sleep()</strong></span> から配列でない値を返す</h4>

   <p class="para">
    配列でない値を
    <a href="language.oop5.magic.php#object.sleep" class="link">__sleep()</a>
    から返すと、警告が発生するようになりました。
   </p>
  </div>

  <div class="sect3" id="migration81.deprecated.core.void-by-ref">
   <h4 class="title"><span class="type"><span class="type"><a href="language.types.void.php" class="type void">void</a></span></span> の関数からリファレンスを返す</h4>

   <p class="para">
    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">function &amp;</span><span style="color: #0000BB">test</span><span style="color: #007700">(): </span><span style="color: #0000BB">void </span><span style="color: #007700">{}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
    上記のような関数は矛盾しているため、
    呼び出された時に
    <code class="literal">Only variable references should be returned by reference</code>
    という <strong><code><a href="errorfunc.constants.php#constant.e-notice">E_NOTICE</a></code></strong>
    が既に発生するようになっています。
   </p>
  </div>

  <div class="sect3" id="migration81.deprecated.core.autovivification-false">
   <h4 class="title"><strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> な変数を自動的に復活させる挙動(Autovivification)</h4>
   <p class="para">
    Autovivification とは、
    値を追加しようとする際に配列を自動で生成する処理のことです。
    スカラー型の値からこのような処理を行うことは禁止されていますが、
    <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> だけは例外でした。
    このバージョンから、この例外も推奨されなくなります。
    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$arr </span><span style="color: #007700">= </span><span style="color: #0000BB">false</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$arr</span><span style="color: #007700">[] = </span><span style="color: #0000BB">2</span><span style="color: #007700">;   </span><span style="color: #FF8000">// 推奨されません<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>
   <blockquote class="note"><p><strong class="note">注意</strong>: 
    <p class="para">
     <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> や 未定義値から、
     自動的に配列を生成する処理は未だ許可されています:
     <div class="informalexample">
      <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #FF8000">// 未定義値から配列を生成<br /></span><span style="color: #0000BB">$arr</span><span style="color: #007700">[] = </span><span style="color: #DD0000">'some value'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$arr</span><span style="color: #007700">[</span><span style="color: #DD0000">'doesNotExist'</span><span style="color: #007700">][] = </span><span style="color: #0000BB">2</span><span style="color: #007700">;<br /></span><span style="color: #FF8000">// null から配列を生成<br /></span><span style="color: #0000BB">$arr </span><span style="color: #007700">= </span><span style="color: #0000BB">null</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$arr</span><span style="color: #007700">[] = </span><span style="color: #0000BB">2</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
      </div>

     </div>
    </p>
   </p></blockquote>
  </div>

 </div>

 <div class="sect2" id="migration81.deprecated.ctype">
  <h3 class="title">ctype 関数</h3>

  <div class="sect3" id="migration81.deprecated.ctype.nonstring-arguments">
   <h4 class="title">文字列でない引数の検証</h4>

   <p class="para">
    ctype関数 に文字列でない引数を渡すことは、
    推奨されなくなりました。
    将来のバージョンでは、引数は ASCII コードポイントではなく、
    文字列として解釈されるようになります。
    ユーザが意図する振る舞いによっては、
    引数を文字列にキャストするか、
    <span class="function"><a href="function.chr.php" class="function">chr()</a></span>
    を明示的にコールすべきです。
    全ての <code class="literal">ctype_*()</code> 関数が影響を受けます。
   </p>
  </div>
 </div>

 <div class="sect2" id="migration81.deprecated.date">
  <h3 class="title">日付・時刻 関数</h3>

  <p class="para">
   <span class="function"><a href="function.date-sunrise.php" class="function">date_sunrise()</a></span>
   と
   <span class="function"><a href="function.date-sunset.php" class="function">date_sunset()</a></span>
   は、推奨されなくなりました。
   <span class="function"><a href="function.date-sun-info.php" class="function">date_sun_info()</a></span>
   を使って下さい。
  </p>

  <p class="para">
   <span class="function"><a href="function.strptime.php" class="function">strptime()</a></span> 関数は、
   推奨されなくなりました。
   (ロケールに依存しないパースを行う場合)
   <span class="function"><a href="function.date-parse-from-format.php" class="function">date_parse_from_format()</a></span>
   または
   (ロケールに依存するパースを行う場合)
   <span class="methodname"><a href="intldateformatter.parse.php" class="methodname">IntlDateFormatter::parse()</a></span>
   を代わりに使って下さい。
  </p>

  <p class="para">
   <span class="function"><a href="function.strftime.php" class="function">strftime()</a></span>
   と
   <span class="function"><a href="function.gmstrftime.php" class="function">gmstrftime()</a></span>
   は、推奨されなくなりました。
   (ロケールに依存しないフォーマットを行う場合)
   <span class="function"><a href="function.date.php" class="function">date()</a></span>
   または
   (ロケールに依存するフォーマットを行う場合)
   <span class="methodname"><a href="intldateformatter.format.php" class="methodname">IntlDateFormatter::format()</a></span>
   を代わりに使って下さい。
  </p>

 </div>

 <div class="sect2" id="migration81.deprecated.filter">
  <h3 class="title">Filter</h3>

  <p class="para">
   <strong><code><a href="filter.constants.php#constant.filter-sanitize-string">FILTER_SANITIZE_STRING</a></code></strong>
   と
   <strong><code><a href="filter.constants.php#constant.filter-sanitize-stripped">FILTER_SANITIZE_STRIPPED</a></code></strong>
   フィルタは、推奨されなくなりました。
  </p>
  <p class="para">
   INI ディレクティブ
   <a href="filter.configuration.php#ini.filter.default" class="link">filter.default</a>
   は、推奨されなくなりました。
   
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.gd">
  <h3 class="title">GD</h3>

  <p class="para">
   <span class="function"><a href="function.imagepolygon.php" class="function">imagepolygon()</a></span>,
   <span class="function"><a href="function.imageopenpolygon.php" class="function">imageopenpolygon()</a></span>,
   <span class="function"><a href="function.imagefilledpolygon.php" class="function">imagefilledpolygon()</a></span>
   の
   <code class="parameter">num_points</code> 引数は、
   推奨されなくなりました。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.hash">
  <h3 class="title">Hash</h3>

  <p class="para">
   <span class="function"><a href="function.mhash.php" class="function">mhash()</a></span>,
   <span class="function"><a href="function.mhash-keygen-s2k.php" class="function">mhash_keygen_s2k()</a></span>,
   <span class="function"><a href="function.mhash-count.php" class="function">mhash_count()</a></span>,
   <span class="function"><a href="function.mhash-get-block-size.php" class="function">mhash_get_block_size()</a></span>,
   <span class="function"><a href="function.mhash-get-hash-name.php" class="function">mhash_get_hash_name()</a></span>
   は、推奨されなくなりました。
   <code class="literal">hash_*()</code> 関数を代わりに使って下さい。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.imap">
  <h3 class="title">IMAP</h3>

  <p class="para">
   定数 <strong><code><a href="imap.constants.php#constant.nil">NIL</a></code></strong> は、推奨されなくなりました。
   <code class="literal">0</code> を代わりに使って下さい。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.intl">
  <h3 class="title">国際化関数(Intl)</h3>

  <p class="para">
   <span class="methodname"><a href="intlcalendar.roll.php" class="methodname">IntlCalendar::roll()</a></span>
   に <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span> 引数を渡してコールすることは、
   推奨されなくなりました。
   <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> と <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>
   の代わりに、
   <code class="literal">1</code> と <code class="literal">-1</code>
   をそれぞれ渡すようにして下さい。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.mbstring">
  <h3 class="title">マルチバイト文字列</h3>

  <p class="para">
   <span class="function"><a href="function.mb-check-encoding.php" class="function">mb_check_encoding()</a></span>
   関数を引数を渡さずにコールすることは、推奨されなくなりました。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.mysqli">
  <h3 class="title">MySQLi</h3>

  <p class="para">
   <span class="property"><a href="class.mysqli-driver.php#mysqli-driver.props.driver-version">mysqli_driver::$driver_version</a></span>
   プロパティは、推奨されなくなりました。
   このプロパティは意味がなく、時代遅れになっています。
   <strong><code><a href="reserved.constants.php#constant.php-version-id">PHP_VERSION_ID</a></code></strong>
   を代わりに使って下さい。
  </p>

  <p class="para">
   <code class="parameter">mysqli</code> 引数を渡して、
   <span class="methodname"><a href="mysqli.get-client-info.php" class="methodname">mysqli::get_client_info()</a></span> や
   <span class="function"><a href="mysqli.get-client-info.php" class="function">mysqli_get_client_info()</a></span>
   をコールすることは、推奨されなくなりました。
   クライアントライブラリのバージョン情報を取得するには、
   <span class="function"><a href="mysqli.get-client-info.php" class="function">mysqli_get_client_info()</a></span>
   を引数なしでコールするようにして下さい。
  </p>

  <p class="para">
   <span class="methodname"><a href="mysqli.init.php" class="methodname">mysqli::init()</a></span> メソッドは、
   推奨されなくなりました。
   <span class="methodname"><strong>parent::init()</strong></span> のコールを
   <span class="methodname"><strong>parent::__construct()</strong></span>
   に置き換えるようにして下さい。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.oci8">
  <h3 class="title">OCI8</h3>

  <p class="para">
   INI ディレクティブ
   <a href="oci8.configuration.php#ini.oci8.old-oci-close-semantics" class="link">oci8.old_oci_close_semantics</a>
   は、推奨されなくなりました。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.odbc">
  <h3 class="title">ODBC</h3>

  <p class="para">
   <span class="function"><a href="function.odbc-result-all.php" class="function">odbc_result_all()</a></span> 関数は推奨されなくなりました。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.pdo">
  <h3 class="title">PDO</h3>

  <p class="para">
   フェッチモードの定数 <strong><code><a href="pdo.constants.fetch-modes.php#pdo.constants.fetch-serialize">PDO::FETCH_SERIALIZE</a></code></strong>
   は、推奨されなくなりました。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.pgsql">
  <h3 class="title">PgSQL</h3>

  <p class="para">
   全ての
   <code class="literal">pgsql_*()</code>
   関数に対して、接続リソースを渡さないことは推奨されなくなりました。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.soap">
  <h3 class="title">SOAP</h3>

  <p class="para">
   <span class="methodname"><a href="soapclient.construct.php" class="methodname">SoapClient::__construct()</a></span>
   の
   <code class="literal">ssl_method</code> オプションは推奨されなくなりました。
   SSL コンテキストオプションを使うのが望ましいです。
   
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.standard">
  <h3 class="title">標準ライブラリ</h3>

  <p class="para">
   <span class="type"><a href="language.types.object.php" class="type object">object</a></span> に対して、
   <span class="function"><a href="function.key.php" class="function">key()</a></span>, <span class="function"><a href="function.current.php" class="function">current()</a></span>,
   <span class="function"><a href="function.next.php" class="function">next()</a></span>, <span class="function"><a href="function.prev.php" class="function">prev()</a></span>,
   <span class="function"><a href="function.reset.php" class="function">reset()</a></span>, <span class="function"><a href="function.end.php" class="function">end()</a></span>
   を呼び出すことは推奨されなくなりました。
   <span class="function"><a href="function.get-mangled-object-vars.php" class="function">get_mangled_object_vars()</a></span> を使って
   最初に <span class="type"><a href="language.types.object.php" class="type object">object</a></span> を配列に変換するか、
   <span class="classname"><a href="class.arrayiterator.php" class="classname">ArrayIterator</a></span> のような
   <span class="interfacename"><a href="class.iterator.php" class="interfacename">Iterator</a></span> を実装したクラスのメソッドを使ってください。
  </p>

  <p class="para">
   INI ディレクティブ
   <a href="filesystem.configuration.php#ini.auto-detect-line-endings" class="link">auto_detect_line_endings</a>
   は、推奨されなくなりました。
   必要な場合は、
   <code class="literal">&quot;\r&quot;</code> を手動で扱うようにして下さい。
  </p>

  <p class="para">
   定数
   <strong><code><a href="filesystem.constants.php#constant.file-binary">FILE_BINARY</a></code></strong> と
   <strong><code><a href="filesystem.constants.php#constant.file-text">FILE_TEXT</a></code></strong> は推奨されなくなりました。
   これらの定数は、使われたことがありませんでした。
  </p>
 </div>

</div><?php manual_footer($setup); ?>