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

contributors($setup);

?>
<div id="migration72.incompatible" class="sect1">
 <h2 class="title">下位互換性のない変更点</h2>

 <div class="sect2" id="migration72.incompatible.number_format-no-neg-zero">
  <h3 class="title"><span class="function"><a href="function.number-format.php" class="function">number_format()</a></span> は負のゼロを返さない</h3>

  <p class="para">
   以前のバージョンでは、<span class="function"><a href="function.number-format.php" class="function">number_format()</a></span> 関数が
   <code class="literal">-0</code> を返せました。
   これは IEEE 754 浮動小数点標準規格に沿ったまったく問題のない値ですが、
   人間が読みやすい形式に数値をフォーマットするという意味では少し不自然でした。
  </p>

  <div class="informalexample">
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">number_format</span><span style="color: #007700">(-</span><span style="color: #0000BB">0.01</span><span style="color: #007700">)); </span><span style="color: #FF8000">// string(2) "-0" ではなく string(1) "0" となります</span></span></code></div>
   </div>

  </div>
 </div>

 <div class="sect2" id="migration72.incompatible.object-array-casts">
  <h3 class="title">オブジェクトと配列の型変換における数値キーの扱い</h3>

  <p class="para">
   配列からオブジェクトへのキャストやその逆のキャストにおける、数値キーの扱いが改善されました。
   明示的なキャストだけではなく <span class="function"><a href="function.settype.php" class="function">settype()</a></span> を使った場合も同様です。
  </p>

  <p class="para">
   数値キーの配列をオブジェクトにキャストしたときに、その要素にアクセスできるようになったのです。
  </p>

  <div class="informalexample">
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #FF8000">// 配列からオブジェクトへの変換<br /></span><span style="color: #0000BB">$arr </span><span style="color: #007700">= [</span><span style="color: #0000BB">0 </span><span style="color: #007700">=&gt; </span><span style="color: #0000BB">1</span><span style="color: #007700">];<br /></span><span style="color: #0000BB">$obj </span><span style="color: #007700">= (object) </span><span style="color: #0000BB">$arr</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(<br />    </span><span style="color: #0000BB">$obj</span><span style="color: #007700">,<br />    </span><span style="color: #0000BB">$obj</span><span style="color: #007700">-&gt;{</span><span style="color: #DD0000">'0'</span><span style="color: #007700">}, </span><span style="color: #FF8000">// アクセスできるようになりました<br />    </span><span style="color: #0000BB">$obj</span><span style="color: #007700">-&gt;{</span><span style="color: #0000BB">0</span><span style="color: #007700">} </span><span style="color: #FF8000">// アクセスできるようになりました<br /></span><span style="color: #007700">);</span></span></code></div>
   </div>

   <p class="para">上の例の出力は以下となります。</p>
   <div class="example-contents screen">
<div class="cdata"><pre>
object(stdClass)#1 (1) {
  [&quot;0&quot;]=&gt;    // 数値キーではなく、文字列のキーになりました
  int(1)
}
int(1)
int(1)
</pre></div>
   </div>
  </div>

  <p class="para">
   また、オブジェクトに数値のキーが含まれる場合に、
   配列にキャストしてもその要素にアクセスできるようになりました。
  </p>

  <div class="informalexample">
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #FF8000">// オブジェクトから配列への変換<br /></span><span style="color: #0000BB">$obj </span><span style="color: #007700">= new class {<br />    public function </span><span style="color: #0000BB">__construct</span><span style="color: #007700">()<br />    {<br />        </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;{</span><span style="color: #0000BB">0</span><span style="color: #007700">} = </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br />    }<br />};<br /></span><span style="color: #0000BB">$arr </span><span style="color: #007700">= (array) </span><span style="color: #0000BB">$obj</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(<br />    </span><span style="color: #0000BB">$arr</span><span style="color: #007700">,<br />    </span><span style="color: #0000BB">$arr</span><span style="color: #007700">[</span><span style="color: #0000BB">0</span><span style="color: #007700">], </span><span style="color: #FF8000">// アクセスできるようになりました<br />    </span><span style="color: #0000BB">$arr</span><span style="color: #007700">[</span><span style="color: #DD0000">'0'</span><span style="color: #007700">] </span><span style="color: #FF8000">// アクセスできるようになりました<br /></span><span style="color: #007700">);</span></span></code></div>
   </div>

   <p class="para">上の例の出力は以下となります。</p>
   <div class="example-contents screen">
<div class="cdata"><pre>
array(1) {
  [0]=&gt;    // 文字列のキーではなく、整数のキーになります
  int(1)
}
int(1)
int(1)
</pre></div>
   </div>
  </div>
 </div>

 <div class="sect2" id="migration72.incompatible.no-null-to-get_class">
  <h3 class="title"><span class="function"><a href="function.get-class.php" class="function">get_class()</a></span> に <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> を渡せない</h3>

  <p class="para">
   以前のバージョンでは、<span class="function"><a href="function.get-class.php" class="function">get_class()</a></span> に <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>
   を渡すと、そのコンテキストの外側のクラスを返していました。
   この機能は削除され、<strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> を渡すと <strong><code><a href="errorfunc.constants.php#constant.e-warning">E_WARNING</a></code></strong> が発生するようになりました。
   以前と同様の挙動を実現したい場合は、<strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> を渡すのではなく単にパラメータを省略するようにしましょう。
  </p>
 </div>

 <div class="sect2" id="migration72.incompatible.warn-on-non-countable-types">
  <h3 class="title">countable ではない型をカウントしたときの警告</h3>

  <p class="para">
   countable ではない型に対して <span class="function"><a href="function.count.php" class="function">count()</a></span> (およびそのエイリアスである
   <span class="function"><a href="function.sizeof.php" class="function">sizeof()</a></span>) を使ったときに
   <strong><code><a href="errorfunc.constants.php#constant.e-warning">E_WARNING</a></code></strong> が発生するようになりました。
  </p>

  <div class="informalexample">
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />var_dump</span><span style="color: #007700">(<br />    </span><span style="color: #0000BB">count</span><span style="color: #007700">(</span><span style="color: #0000BB">null</span><span style="color: #007700">), </span><span style="color: #FF8000">// NULL はカウントできません<br />    </span><span style="color: #0000BB">count</span><span style="color: #007700">(</span><span style="color: #0000BB">1</span><span style="color: #007700">), </span><span style="color: #FF8000">// integer はカウントできません<br />    </span><span style="color: #0000BB">count</span><span style="color: #007700">(</span><span style="color: #DD0000">'abc'</span><span style="color: #007700">), </span><span style="color: #FF8000">// string はカウントできません<br />    </span><span style="color: #0000BB">count</span><span style="color: #007700">(new </span><span style="color: #0000BB">stdClass</span><span style="color: #007700">), </span><span style="color: #FF8000">// Countable インターフェイスを実装していないオブジェクトはカウントできません<br />    </span><span style="color: #0000BB">count</span><span style="color: #007700">([</span><span style="color: #0000BB">1</span><span style="color: #007700">,</span><span style="color: #0000BB">2</span><span style="color: #007700">]) </span><span style="color: #FF8000">// array はカウントできます<br /></span><span style="color: #007700">);</span></span></code></div>
   </div>

   <p class="para">上の例の出力は以下となります。</p>
   <div class="example-contents screen">
<div class="cdata"><pre>
Warning: count(): Parameter must be an array or an object that implements Countable in %s on line %d

Warning: count(): Parameter must be an array or an object that implements Countable in %s on line %d

Warning: count(): Parameter must be an array or an object that implements Countable in %s on line %d

Warning: count(): Parameter must be an array or an object that implements Countable in %s on line %d
int(0)
int(1)
int(1)
int(1)
int(2)
</pre></div>
   </div>
  </div>
 </div>

 <div class="sect2" id="migration72.incompatible.hash-ext-to-objects">
  <h3 class="title">ext/hash がリソースからオブジェクトへ</h3>

  <p class="para">
   長期にわたるリソースからオブジェクトへの移行作業の一環として、
   <a href="book.hash.php" class="link">Hash</a> 拡張モジュールがリソースではなくオブジェクトを使うようになりました。
   開発者側から見て特に変わるところはありませんが、もし
   <span class="function"><a href="function.is-resource.php" class="function">is_resource()</a></span> を使ったチェックを行っているのなら、
   それを <span class="function"><a href="function.is-object.php" class="function">is_object()</a></span> に書き換える必要があります。
  </p>
 </div>

 <div class="sect2" id="migration72.incompatible.ssl-tls-defaults">
  <h3 class="title">SSL/TLS のデフォルトの改善</h3>

  <p class="para">
   デフォルト設定が以下のように変わりました。
  </p>

  <ul class="itemizedlist">
   <li class="listitem">
    <span class="simpara">
     <code class="literal">tls://</code> が、TLSv1.0 や TLSv1.1 や TLSv1.2 のデフォルトになりました。
    </span>
   </li>
   <li class="listitem">
    <span class="simpara">
     <code class="literal">ssl://</code> は <code class="literal">tls://</code> のエイリアスになりました。
    </span>
   </li>
   <li class="listitem">
    <span class="simpara">
     <code class="literal">STREAM_CRYPTO_METHOD_TLS_*</code> 定数のデフォルトが、
     TLSv1.0 だけではなく TLSv1.0 または TLSv1.1 + TLSv1.2 となりました。
    </span>
   </li>
  </ul>
 </div>

 <div class="sect2" id="migration72.incompatible.gettype-on-closed-resource">
  <h3 class="title"><span class="function"><a href="function.gettype.php" class="function">gettype()</a></span> にクローズ済みのリソースを渡した際の戻り値</h3>

  <p class="para">
   以前のバージョンでは、 <span class="function"><a href="function.gettype.php" class="function">gettype()</a></span> にクローズ済みのリソースを渡すと、<code class="literal">&quot;unknown type&quot;</code> という文字列を返していました。
   これからは、 <code class="literal">&quot;resource (closed)&quot;</code> という文字列が返されます。
  </p>
 </div>

 <div class="sect2" id="migration72.incompatible.is_object-on-incomplete_class">
  <h3 class="title"><span class="function"><a href="function.is-object.php" class="function">is_object()</a></span> と <span class="classname"><a href="class.php-incomplete-class.php" class="classname">__PHP_Incomplete_Class</a></span></h3>

  <p class="para">
   以前のバージョンでは、  <span class="classname"><a href="class.php-incomplete-class.php" class="classname">__PHP_Incomplete_Class</a></span> クラスに対して、
   <span class="function"><a href="function.is-object.php" class="function">is_object()</a></span> を使うと <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> が返されていました。
   これからは <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> が返されます。
  </p>
 </div>

 <div class="sect2" id="migration72.incompatible.undefined-constants">
  <h3 class="title">定義されていない定数のエラーレベル変更</h3>

  <p class="para">
   定義されていない定数への参照を行った場合、 <strong><code><a href="errorfunc.constants.php#constant.e-warning">E_WARNING</a></code></strong> を生成するようになりました。
   (今までは <strong><code><a href="errorfunc.constants.php#constant.e-notice">E_NOTICE</a></code></strong>を生成していました。)
   次のPHPメジャーバージョンでは、<span class="classname"><a href="class.error.php" class="classname">Error</a></span> 例外を生成するように変更される予定です。
  </p>
 </div>

 <div class="sect2" id="migration72.incompatible.windows-support">
  <h3 class="title">Windows サポート</h3>

  <p class="para">
   現在、公式にサポートしている最低バージョンは Windows 7/Server 2008 R2です。
  </p>
 </div>

 <div class="sect2" id="migration72.incompatible.trait-properties">
  <h3 class="title">trait のプロパティの値チェック</h3>

  <p class="para">
   trait のプロパティの値に対して互換性があるかどうかをチェックするときは、値のキャストを行わなくなりました。
  </p>
 </div>

 <div class="sect2" id="migration72.incompatible.object-reserved-word">
  <h3 class="title"><code class="literal">object</code> をクラス名に使う</h3>

  <p class="para">
   <code class="literal">object</code> という名前は、PHP 7.0 では緩く予約されていました。
   PHP 7.2 からは制約が強くなり、クラスや trait、インターフェイスの名前として使うことが禁止されます。
  </p>
 </div>

 <div class="sect2" id="migration72.incompatible.netware-support">
  <h3 class="title">NetWare サポート</h3>

  <p class="para">
   NetWareのサポートが削除されました。
  </p>
 </div>

 <div class="sect2" id="migration72.incompatible.array-unique">
  <h3 class="title"><span class="function"><a href="function.array-unique.php" class="function">array_unique()</a></span> 関数を
  <strong><code><a href="array.constants.php#constant.sort-string">SORT_STRING</a></code></strong> と使う場合</h3>

  <p class="para">
   <span class="function"><a href="function.array-unique.php" class="function">array_unique()</a></span> 関数を <strong><code><a href="array.constants.php#constant.sort-string">SORT_STRING</a></code></strong>
   と使う場合、以前は配列をコピーし、重複した要素を削除
   (配列を後にパックせずに) していましたが、このバージョンからは
   新しい配列作られ、ユニークな要素を追加するようになりました。
   これにより、以前のバージョンとは異なった数値のインデックスが生成されます。
  </p>
 </div>

 <div class="sect2" id="migration72.incompatible.bcmod-and-floats">
  <h3 class="title"><span class="function"><a href="function.bcmod.php" class="function">bcmod()</a></span> の小数点に対する挙動変更</h3>

  <p class="para">
   <span class="function"><a href="function.bcmod.php" class="function">bcmod()</a></span> 関数が小数点切り捨てをしないようになりました。
   これからは、挙動は <code class="literal">%</code> 演算子ではなく、 <span class="function"><a href="function.fmod.php" class="function">fmod()</a></span>に準拠します。
   たとえば、 <code class="literal">bcmod(&#039;4&#039;, &#039;3.5&#039;)</code> はいままでの<code class="literal">1</code>ではなく、 <code class="literal">0.5</code> を返します。
  </p>
 </div>

 <div class="sect2" id="migration72.incompatible.hash-functions">
  <h3 class="title">ハッシュ関数と非暗号化ハッシュ</h3>

  <p class="para">
   <span class="function"><a href="function.hash-hmac.php" class="function">hash_hmac()</a></span>、 <span class="function"><a href="function.hash-hmac-file.php" class="function">hash_hmac_file()</a></span>、
   <span class="function"><a href="function.hash-pbkdf2.php" class="function">hash_pbkdf2()</a></span>、 および <span class="function"><a href="function.hash-init.php" class="function">hash_init()</a></span> (
   <strong><code><a href="hash.constants.php#constant.hash-hmac">HASH_HMAC</a></code></strong>) は非暗号化ハッシュを受け入れないように変更されました。
  </p>
 </div>

 <div class="sect2" id="migration72.incompatible.json_decode-changes">
  <h3 class="title"><span class="function"><a href="function.json-decode.php" class="function">json_decode()</a></span> 関数のオプション</h3>

  <p class="para">
   <span class="function"><a href="function.json-decode.php" class="function">json_decode()</a></span> 関数のオプション、
   <strong><code><a href="json.constants.php#constant.json-object-as-array">JSON_OBJECT_AS_ARRAY</a></code></strong> は、2番めのパラメータ (assoc) が <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>
   の場合に使用されるようになりました。
   <strong><code><a href="json.constants.php#constant.json-object-as-array">JSON_OBJECT_AS_ARRAY</a></code></strong> はこれまで無視されていました。
  </p>
 </div>

 <div class="sect2" id="migration72.incompatible.rand-mt_rand-output">
  <h3 class="title"><span class="function"><a href="function.rand.php" class="function">rand()</a></span> と <span class="function"><a href="function.mt-rand.php" class="function">mt_rand()</a></span> の出力</h3>

  <p class="para">
   特定のシードで <span class="function"><a href="function.rand.php" class="function">rand()</a></span> と
   <span class="function"><a href="function.mt-rand.php" class="function">mt_rand()</a></span> で生成されたシーケンスは、64-bit マシンで動作しているPHP 7.1と値が異なる場合があります。
   (モジュロバイアスのバグ修正が実装されました。).
  </p>
 </div>

 <div class="sect2" id="migration72.incompatible.sqlsafe_mode-ini-setting">
  <h3 class="title"><a href="ini.core.php#ini.sql.safe-mode" class="link"><code class="parameter">sql.safe_mode</code></a> のini設定削除</h3>

  <p class="para">
   <code class="parameter">sql.safe_mode</code> のini設定が削除されました。
  </p>
 </div>

 <div class="sect2" id="migration72.incompatible.date_parse_from_format">
  <h3 class="title"><span class="function"><a href="function.date-parse.php" class="function">date_parse()</a></span> と
  <span class="function"><a href="function.date-parse-from-format.php" class="function">date_parse_from_format()</a></span> 関数への変更</h3>

  <p class="para">
   <span class="function"><a href="function.date-parse.php" class="function">date_parse()</a></span> 関数 と
   <span class="function"><a href="function.date-parse-from-format.php" class="function">date_parse_from_format()</a></span> 関数
   が返す <code class="literal">zone</code> 要素は、
   分ではなくて秒を表現するようになり、符号も逆になりました。
   たとえば <code class="literal">-120</code> 分は
   <code class="literal">7200</code> 秒を意味するようになりました。
  </p>
 </div>

 <div class="sect2" id="migration72.incompatible.cookie-decode">
  <h3 class="title">外部から入力されるCookie</h3>

  <p class="para">
   PHP 7.2.34 以降は、セキュリティ上の理由により、
   外部から入力される Cookie の
   <em>名前</em> はurlデコードされなくなりました。
  </p>
 </div>

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