「PHP」の版間の差分

== About==

=== About ===

具体的には、php.ini/.user.iniで以下を指定して、PHP v7.4時点で警告にできるだけ対応しておく。

*PHP CodeSniffer: コーディング規約の準拠確認ツール。PHPのバージョンアップグレード可否チェックもできる。

*PHPStan: 静的解析ツール。引数の数、型不一致など、潜在的な問題を検出する。

*Rector

* paiza.IO: [https://paiza.io/ja/projects/new Online PHP Editor | ブラウザでプログラミング・実行ができる「オンライン実行環境」| paiza.IO]: パーマリンク。

* phpsansbox.io [https://phpsandbox.io/ Write PHP online from your browser - PHPSandbox]: フレームワークも確認可能。

* OnlinePHP.io: [https://onlinephp.io/ PHP Sandbox - Execute PHP code online through your browser]: 複数バージョンの同時実行できる。

* 3v4l.org: [https://3v4l.org/ Online PHP editor | Test code in 250+ PHP versions]: パーマリンク。

=== Guide ===

「[https://stackoverflow.com/questions/1209720/what-should-i-name-my-php-class-file What should I name my PHP class file? - Stack Overflow]」にあるように、PSRではファイル名には記載がない。PSR-4や「[https://www.php-fig.org/bylaws/psr-naming-conventions/ PSR Naming Conventions - PHP-FIG]」に記載がある程度。

* [https://www.php.net/manual/ja/language.oop5.properties.php PHP: プロパティ - Manual]

* クラス名: CamelCase

* メソッド名: mixedCase

* 定数: UPPER_SNAKE_CASE

* プロパティー: PSRでの規定はない。公式文書だとmixedCase

* 変数名: PSRでの規定はない。公式文書だとlower_snake_case

=== Performance ===

* 言語構造>組込関数>関数の順に速い。

==== Time ====

===== in_array/array_search =====

[https://thk.kanzae.net/net/itc/t2379/ PHP 高速化に関するメモ書き | Thought is free]

PHPの言語構造の中で、isset/emptyが非常に重要。これらで値の有無判定ができる。

echo (fn($c)=>[$s=hrtime(1),$c(),hrtime(1)-$s][2])(function()use($a){in_array(500, $a);}), " ns\n";

echo (fn($c)=>[$s=hrtime(1),$c(),hrtime(1)-$s][2])(function()use($a){isset(array_flip($a)[500]);}), " ns\n";

echo (fn($c)=>[$s=hrtime(1),$c(),hrtime(1)-$s][2])(function()use($a){isset(array_combine($a, range(1,count($a)))[500]);}), " ns\n";

*null

*float (floating-point number)

==== System ====

** スカラー型: bool/int/float/string

** クラス内の相対型: self/parent/static

* Value型: false/true

* ユーザー定義型/クラス型

===== 複合型 =====

* 交差型: 宣言した複数のクラス型をすべて満たす型。&で表現。T/U/Vの交差型はT&U&Vと書く。

* union型: 複数の型を受け入れる型。|で表現。T/U/Vのunion型はT|U|Vと書く。交差型を含む場合、T|(X&U)と丸括弧で囲む必要がある。

* mixed=object|resource|array|string|float|int|bool|null: PHP 8.0.0で導入。mixedは型のトップ。他の全部の型はこの型の部分になる。

* iterable=Traversable|array: PHP 7.1.0で導入。foreachで反復可能でジェネレーター内でyield from可能。

Ref: [https://www.php.net/manual/ja/language.types.string.php PHP: 文字列 - Manual].

Here document/Nowdocは終端IDのインデントで行頭を識別しており、インデントに意味があるので注意する。

  echo <<<'EOT'

  My name is "$name". I am printing some $foo->foo.

Now, I am printing some {$foo->bar[1]}.

|<code>\v</code>

|<code>\[0-7]{1,3}</code>

|8進数: 正規表現 <code>[0-7]{1,3}</code> にマッチする文字シーケンスは、8 進数表記の 1 文字 (例:. <code>"\101" === "A"</code>) です。 正規表現にマッチする文字シーケンスは、8 進数表記の 1 文字です。 1 バイトに収まらない部分は、何もメッセージを出さずにオーバーフローします (例: <code>"\400" === "\000"</code>) 。

|<code>\x[0-9A-Fa-f]{1,2}</code>

|16進数: 正規表現 <code>[0-9A-Fa-f]{1,2}</code> にマッチする文字シーケンスは、16 進数表記の 1 文字(例: <code>"\x41" === "A"</code>)です。

|Unicode: 正規表現 <code>[0-9A-Fa-f]+</code> にマッチする文字シーケンスは、Unicode のコードポイントです。 そのコードポイントの UTF-8 表現を文字列として出力します。 シーケンスを波括弧で囲む必要があります。例 <code>"\u{41}" === "A"</code>

|}

二重引用符とヒアドキュメントではエスケープシーケンスが解釈され、変数が展開される。<syntaxhighlight lang="php">

<?php

echo "He drank some $juice juice." . PHP_EOL;

echo "He drank some juice made of $juices." . PHP_EOL;

 

// 参照する変数名を波括弧で囲むことで、変数名の終端を明示的に指定しています。

echo "He drank some $juices[0] juice.".PHP_EOL;

// 動作します。多次元配列を使用する際は、

// 複雑な例。二重展開で変数になる場合だけ式が使える模様。

$var1=9;

echo "{${mb_strtolower('VAR1')}}"; // 9

?>

</syntaxhighlight>波括弧はなくてもいいが、文字列が連結するなどして変数名の終端を区別できない場合に必須になる。

複雑な形式は{$ ... }がセット。{$ } 部分で変数が式扱いになる。

*[https://chaika.hatenablog.com/entry/2023/02/14/120000 PHP 文字列中に変数で値を埋め込むやつのメモ - かもメモ]

*[https://qiita.com/iez/items/8a36e5cba8bf6af21f45 python の string.format が便利だからPHPでも使いたい #PHP - Qiita]

*sprintf/vprintf

Ref: [https://www.php.net/manual/ja/function.sprintf.php PHP: sprintf - Manual]

C言語のprintfといろいろ違うところがある。<syntaxhighlight lang="php">

$format = 'The %2$s contains %1$d monkeys.

          That\'s a nice %2$s full of %1$d monkeys.';

echo sprintf("%'.9d\n", 123); // ......123

echo sprintf("%'.09d\n", 123); // 000000123

=====文字列の切り出し=====

*strpos/mb_strpos/strrpos/mb_strrpos ([https://www.php.net/manual/ja/function.strpos.php PHP: strpos - Manual])

*[https://www.php.net/manual/ja/function.str-replace.php PHP: str_replace - Manual]: 日本語不能。記号の置換などで便利。

*[https://www.php.net/manual/ja/function.substr-replace.php PHP: substr_replace - Manual]: 日本語不能。指定した文字数の位置で置換する。

  ): string|array

$query = $request->query();

foreach ($query as $key => $value) {

$keys = explode('_', $key);

$key = implode('_', array_slice($keys, 0, -1)) . '.' . $keys[count($keys)-1];

$query[$key] = $value;

=====startsWith/endsWith=====

PHP 8なら「[https://www.php.net/manual/en/function.str-starts-with.php PHP: str_starts_with - Manual]/[https://www.php.net/manual/en/function.str-ends-with.php PHP: str_ends_with - Manual]」がある。

function startsWith( $haystack, $needle ) {

      $length = strlen( $needle );

      return substr( $haystack, 0, $length ) === $needle;

  }

  function endsWith( $haystack, $needle ) {

    return substr( $haystack, -$length ) === $needle;

 

===== 改行分割 =====

 

* [https://stackoverflow.com/questions/3997336/explode-php-string-by-new-line Explode PHP string by new line - Stack Overflow]

* [https://stackoverflow.com/questions/1483497/split-string-by-new-line-characters php - Split string by new line characters - Stack Overflow]

* [https://stackoverflow.com/questions/7836632/how-to-replace-different-newline-styles-in-php-the-smartest-way How to replace different newline styles in PHP the smartest way? - Stack Overflow]

上記がいい。\Rが\r \n \n\rなどにマッチ。uで入力がUTF-8の場合を考慮。例えば、「腰」がuをつけないと分割されてしまう。

===== trim =====

[https://www.php.net/manual/ja/function.trim.php PHP: trim - Manual]

[https://www.php.net/manual/ja/function.str-repeat.php PHP: str_repeat - Manual]

str_repeat(string $string, int $times): string

プリペアードステートメントで(?,?)を作るときとかで使う。

  function timeit(callable $callback)

  <nowiki> </nowiki>  $time = 'microtime';

<nowiki> </nowiki>  }

<nowiki> </nowiki>   $start = $time(true);

<nowiki> </nowiki><nowiki>  return ($stop - $start) * $nanoFactor;

                                                                                                                                      echo timeit(function(){for ($i = 0; $i<10000; ++$i){substr(str_repeat('?,', 10000), 0, -1);}}) . '=substr' . PHP_EOL;

                                                                                                                                      echo timeit(function(){for ($i = 0; $i<10000; ++$i) {implode(',', array_fill(0, 10000, '?'));}}) . '=array' . PHP_EOL;

                                                                                                                                      echo timeit(function(){for ($i = 0; $i<10000; ++$i) {implode(',', array_fill(0, 10000, '?'));}}) . '=array' . PHP_EOL;

                                                                                                                                      /*

<nowiki>*</nowiki>/

 

[https://www.php.net/manual/ja/function.substr-count.php PHP: substr_count - Manual]

    string $haystack,

    string $needle,

    int $offset = 0,

  echo substr_count($text, 'is'); // 2

  substr_count($str,"\n");

* [https://www.fourier.jp/blog/php-read-csv-utf8-with-bom UTF-8BOM有無両対応のCSVファイル読み込み（PHP） | 株式会社フーリエ | Web戦略・システム開発［東京/浜松］]

* [https://qiita.com/tf_okrt/items/be81cd66e38fc38d3aeb php で csv を読み込む上での備忘録 #PHP - Qiita]

* [https://stackoverflow.com/questions/26679980/csv-upload-parsing-with-splfileobject-remove-bom php - CSV upload - parsing with SplFileObject - Remove BOM - Stack Overflow]

$header[0] = preg_replace('/^\xEF\xBB\xBF/', <nowiki>''</nowiki>, $header[0]);

if ($file->fread(3) !== pack('C*', 0xEF, 0xBB, 0xBF)) {

 

  $bom = pack('CCC', 0xEF, 0xBB, 0xBF);

  $first = true;

  foreach ($file as $line) {

    if ($first && substr($line, 0, 3) === $bom) {

        $line = substr($line, 3);

    $first = false;

    // your lines don't have a BOM, do your stuff

$line = (substr($line, 0, 3) === "\xEF\xBB\xBF") ? trim(substr($line, 3), '"') : $line;

        $current = $this->file->current();

            $current[0] = (substr($line, 0, 3) === "\xEF\xBB\xBF") ? trim(substr($line, 3), '"') : $line;

====Array====

    key  => value,

    key2 => value2,

    key3 => value3,

    ...

====== Basic ======

*array()/[]

*explode ([https://www.php.net/manual/ja/function.explode.php PHP: explode - Manual])

*array_map

  $arr[キー] = 値；

$arr[] = 値;

// キーは文字列か整数。

   

  $arr = [

  'key1' => 'value1',

  ];

array()の他に[]も使える。[]のほうが短いのでこちらがいいだろう。

$arrが存在しないか、null/falseの場合、新しい配列を作成する。ただし、この方法は万が一既存の変数があったら、追加になるのであまり推奨されない。明示的に初期化したほうがいい。

====== Serial ======

* [https://www.php.net/manual/ja/function.range.php PHP: range - Manual]

* [https://www.php.net/manual/ja/function.str-repeat.php PHP: str_repeat - Manual]

array_fill(int $start_index, int $count, mixed $value): array

$a = array_fill(5, 6, 'banana');

print_r($a);

(

    [9]  => banana

array_fill_keys(array $keys, mixed $value): array

  $a = array_fill_keys($keys, 'banana');

    [foo] => banana

    [5] => banana

    [10] => banana

    [bar] => banana

)

  range(0, 12)

連続データを作成出来たら、array_combine/array_keys/array_valuesなどの組み合わせで、キーと値は調整できる。

* range: 指定要素数配列

* array_fill/array_fill_keys: 指定値の指定要素数配列。連想配列で複数キーに同じ値を設定したい場合に使う。

====== Merge ======

array_merge($arr, [0, 1]); // 配列同士の追加。

$arr = [...$arr, ...[0, 1]] // PHP7.4以上。...演算子。性能はarray_mergeのほうが高い。

基本は$arr[キー] $arr[]でいいだろう。キーと値の配列から連想配列を作るには、array_combine。重宝する。

foreach ($array as &$row) {

    $row[] = $newElement; // 各行の末尾に要素を追加

$array = array_map(function($row) use ($newElement) {

 

 

 

===== Read =====

====== 角括弧構文による配列要素へのアクセス ======

なお、これとは別でstring access operator (文字列アクセス演算子)、インデックス演算子と呼ぶこともあるが、演算子ではないので「[https://www.php.net/manual/en/language.operators.php PHP: Operators - Manual]」に記載はない。

未定義キーへのアクセスは、未定義変数へのアクセスと同じ扱い。つまり、E_WARNING レベルの警告 (PHP 8.0.0 より前のバージョンでは E_NOTICE) が発生し、結果が null。

https://chatgpt.com/c/67a405d2-7614-800b-9f41-811812718dac

なお、配列以外の型に角括弧構文を使った文字列キーアクセスの挙動には注意が必要基本はFatal error (isset/emptyでのガードも不能) になる。

 

[https://hishikiryu.com/php-get-last-array-value/ 【PHP】配列の最後（末尾）の要素を取得まとめ array_key_last, count, end関数 | ヒシキリュウ.com]

* count: 昔ながら ($arr[count($arr) - 1];)。

[https://gen0e0.hatenablog.com/entry/2018/03/16/164714 PHPの連想配列から一部を切り出す話 - あしたにっき]

* array_intersect/array_intersect_key: 指定したキーの配列だけ取得。

* array_diff/array_diff_key: 指定したキー以外の配列を取得。

連想配列で指定キー/指定キー以外の一括取得でよく使う。

array_diff_key($haystack, array_flip($needles));

====== 連想配列の先頭・末尾 ======