最大最小

max、minは最大、最小の値を返す。引数には１個の配列または１個以上の変数を指定する。

• 配列を指定した場合は配列要素内で最大・最小の値、変数群を指定した場合は変数群の中で最大・最小の値が返される。
• 値が数値ではない要素または変数については 0 とみなして判定される。
• 同じ大きさの値が複数あった場合は、最初にあらわれたものを返す。
• 最大最小値が 0 となった場合の扱いは以下の通り。

  文字種	扱い
  数値を含む	数値
  文字列のみ	文字コードが一番大きい（maxの場合）/小さい（minの場合）文字列

四捨五入・切り上げ・切り捨て

丸める桁数

round関数において、四捨五入した結果を小数点以下何桁までの数値で返すかを数値で指定する。 負数を指定した場合は、小数点の上を意味する（例：-1→10の位、-2→100の位）。指定がない場合の既定値は0（小数点以下を四捨五入して整数に丸める）。

中間値の扱い

round関数において、丁度中間の値であった場合の扱いを指定する。指定できる値は下表の４種。

値	内容	例
PHP_ROUND_HALF_UP	丁度中間の値は切り上げる （指定がない場合の既定の動作）	echo round(1.5, 0, PHP_ROUND_HALF_UP); → 2
PHP_ROUND_HALF_DOWN	丁度中間の値は切り捨てる	echo round(1.5, 0, PHP_ROUND_HALF_DOWN); → 1
PHP_ROUND_HALF_EVEN	偶数側に丸める	echo round(1.5, 0, PHP_ROUND_HALF_EVEN); → 2 echo round(2.5, 0, PHP_ROUND_HALF_EVEN); → 2
PHP_ROUND_HALF_ODD	奇数側に丸める	echo round(1.5, 0, PHP_ROUND_HALF_ODD); → 1 echo round(2.5, 0, PHP_ROUND_HALF_ODD); → 3

余り（剰余）

fmodは指定した数で割り算した時の余り（剰余）を返す。

【書式】
fmod(被除数,除数);
【戻り値】
剰余
      

「被除数 = 除数 × 商 ＋ 余り」の関係になる。

%演算子を使った場合と同じ？ 以下の例を見る限り、同じに見える。

$ cat test.php
<?php
echo "10 % 3 （10÷3の余り）= ".(10 % 3)."\n";
echo "fmod(10,3) （10÷3の余り）= ".fmod(10,3)."\n";
?>
$ php test.php
10 % 3 （10÷3の余り）= 1
fmod(10,3) （10÷3の余り）= 1

指数

powは指数計算を行う。

【書式】
pow(基数,指数);
      

戻り値は基数を指数乗した値（整数型の値）。指数が計算できない場合は false を返す。

対数

log10は底を10とする対数を返す。その他の底を使う時はlogを用いる

【書式】
log10(真数);
log(真数,底);

【引数】
真数：浮動小数点数（float）
[logのみ]底：浮動小数点数（float）
　指定がない場合の既定値はネピア数（e、自然対数の底）

【戻り値】
[log10]
10を底とする真数の対数：浮動小数点数（float）
[log]
指定した底と真数に対する対数：浮動小数点数（float）

      

乱数

randは乱数を生成して返す。引数を指定しない場合は0からgetrandmaxの間の擬似乱数（整数）を、指定した場合はその範囲内の擬似乱数（整数）を返す。いずれも範囲には端点を含む。

【書式】
rand();
rand(最小値（整数）,最大値（整数）);
      

なお、randよりも生成速度などに優れたmt_rand関数もある。使い方は同じ。引数を指定しない場合の最大値はmt_getrandmaxで取得できる。

【書式】
mt_rand();
mt_rand(最小値（整数）,最大値（整数）);
      

一意な文字列を生成

uniqidはマイクロ秒単位の現在時刻にもとづいた、指定した接頭辞つきの一意な文字列を返す。戻り値の文字数は more_entropy が false の場合は（接頭辞＋13 文字）、true の場合は（接頭辞＋23 文字）。

【書式】
uniqid(接頭辞,more_entropy);
      

接頭辞

生成される値の前に付加する文字列。複数ホストで同時に値を生成する場合、同一時刻なら同一の値を生成してしまう可能性があるが、接頭辞を付加することでそのような事態を防ぐことができる。指定がない場合の既定値は空の接頭辞（接頭辞なし）。

more_entropy

true を指定すると、線形合同法を使用したエントロピーが戻り値の最後に追加され、結果の一意性がより増す。指定がない場合の既定値は false。

絶対値

absは絶対値を返す。引数が浮動小数点（float）型の値であった場合は浮動小数点型、それ以外は整数型の値を返す。

【書式】
abs(値);
      

出力先のバッファリング開始（ob_start）

ob_startは出力のバッファリングを開始する。バッファリングを開始すると、ヘッダを除くスクリプトからの出力内容が内部バッファに蓄積される。

【書式】
ob_start();
【戻り値】
成功→true
失敗→false

出力バッファの内容取得、バッファリング終了、バッファ消去

• ※１：出力バッファリングが有効になっている状態での戻り値。出力バッファリングが有効になっていない時の戻り値は false。
• ※２：「消去」は標準出力にバッファ内容を送ってからバッファ内容を消去し、「破棄」は標準出力にバッファ内容を送ることなくバッファ内容を消去する。

【書式】
ob_get_contents();
【戻り値】
出力のバッファリングが有効になっている時→出力バッファの内容
出力のバッファリングが有効になっていない時→false

【例】
<?php
ob_start();  #- 出力バッファリング開始
$log = 'hoge.log';  #- 出力先ファイル名定義
$handle = fopen($log,'w');  #- 出力先ファイルを開く
if ($handle) {
  echo "The log file was opened successfully.\n";
} else {
  echo "The log file couldn't be opened.\n";
}
fwrite($handle,ob_get_contents());  #- バッファ内容をファイルに書き込む
fclose($handle);  #- ファイルを閉じる
?>

参考文献・サイト

• 標準出力結果をファイルに出力する方法【PHP】 - Programming Magic
• 入出力制御

文字列の出力

• 特殊文字
• そのまま出力（echo、print）
• 指定書式で出力（printf、sprintf）
• 指定個出力（str_repeat）
• 配列を整形して出力（print_r）
• 変数情報を出力（var_dump）

【書式】
echo 出力内容,出力内容,...
print 出力内容

【戻り値】
echo→なし
print→常に1

【例】
$ cat test.php
<?php
echo ("Hello World from echo with parentheses.\n");
print ("Hello World from print with parentheses.\n");
echo "Hello World from echo without parentheses.\n";
print "Hello World from print without parentheses.\n";
?>
$ php test.php
Hello World from echo with parentheses.
Hello World from print with parentheses.
Hello World from echo without parentheses.
Hello World from print without parentheses.

【例】
$ cat test.php
<?php
$keyword = 'Hello World';
echo "$keyword from echo\n surrounded by double quote.\n";
print "$keyword from print\n surrounded by double quote.\n";
echo '$keyword from echo\n surrounded by single quote.\n'."\n";
print '$keyword from print\n surrounded by single quote.\n'."\n";
?>
$ php test.php
Hello World from echo
 surrounded by double quote.
Hello World from print
 surrounded by double quote.
$keyword from echo\n surrounded by single quote.\n
$keyword from print\n surrounded by single quote.\n

【例】
$ cat test.php
<?php
echo "echoの引数は複数行に渡って
書くことができます\n";
print "printの引数も複数行に渡って
書くこともできます\n";
?>
$ php test.php
echoの引数は複数行に渡って
書くことができます
printの引数も複数行に渡って
書くこともできます

<?php
$x = 100;
$y = 120;
echo $x . " - " . $y . " = " . ($x -$y) . "\n";
echo $x . " - " . $y . " = " . $x -$y . "\n";
?>

【処理結果】
100 - 120 = -20
-20
	

【書式】
(s)printf(書式指定,文字列1,文字列2...)

【例】
$num = 5;
$location = 'tree';
$format = 'There are %d monkeys in the %s'; ←"%d"は整数10進数、"%s"は文字列
printf($format, $num, $location); ←There are 5 monkeys in the tree

$format2 = 'The %2$s contains %1$d monkeys'; ←"%"＋数値で何番目の引数を割り当てるかを指定できる
                                            （指定が無ければ登場順）
printf($format2, $num, $location); ←The tree contains 5 monkeys
	

echo sprintf('%+d','12345');
→ +12345
echo sprintf('%+d','-12345');
→ -12345
echo sprintf('%d','12345');
→ 12345
echo sprintf('%d','-12345');
→ -12345

echo sprintf('% 10s','12345');
→      12345
echo sprintf('%010s','hoge');
→ 000000hoge
echo sprintf('%'#10s','hoge');
→ ######hoge

echo sprintf('[%-10s]','hoge123');
→ [hoge123   ]
echo sprintf('[%10s]','hoge123');
→ [   hoge123]

echo sprintf('%.2f','123.4567');
→ 123.45
echo sprintf('%.5f','123.4567');
→ 123.45670
echo sprintf('%.5f','hogehoge');
→ hogeh

echo sprintf('%b','55');
→ 110111
※10進数55を２進数に直すと "110111"

echo sprintf('%c','55');
→ 7
※キャラクターコード55の文字は "7"

echo sprintf('%d','55');
→ 55

echo sprintf('%e','55');
→ 5.50000e+1

echo sprintf('%e','-55');
→ 4294967241

【例】小数点以下３桁表示
echo sprintf('%.3f','55');
→ 55.000
【例】８文字固定長右揃え
echo sprintf('% 8s',sprintf('%.3f','55'));
→   55.000

【例】通常、幅10文字右詰め、幅10文字左詰め
$ php -r "echo sprintf('[%s]','hoge').\"\n\";"
[hoge]
$ php -r "echo sprintf('[%10s]','hoge').\"\n\";"
[      hoge]
$ php -r "echo sprintf('[%-10s]','hoge').\"\n\";"
[hoge      ]

【書式と戻り値】
str_repeat(文字列,回数);
→文字列を指定回数繰り返した文字列（文字列 string 型）

==== test.php ===
<?php
$a = array(1, 2, array("a", "b", "c"));
$b = 1.23;
$c = true;
$d = "abc";
var_dump($a);
var_dump($b);
var_dump($c);
var_dump($d);
?>

=================
shell> ./test.php
array(3) {
  [0]=>
  int(1)
  [1]=>
  int(2)
  [2]=>
  array(3) {
    [0]=>
    string(1) "a"
    [1]=>
    string(1) "b"
    [2]=>
    string(1) "c"
  }
}
float(1.23)
bool(true)
string(3) "abc"

【例】
<?php
ob_start(); # 出力バッファリング開始
var_dump($var); # 変数varの内容をダンプ
$output = ob_get_contents(); # バッファ内容を変数に代入
ob_end_clean(); # バッファ内容を破棄してバッファリング終了
?>

文字列情報

• 文字列の長さを返す（strlen、mb_strlen）
• 文字列の出現回数を返す（substr_count）
• 文字列のMD5ハッシュ値を計算する（md5）
• 文字列の型情報は型判定・値の比較参照

【書式】
strlen(文字列)
mb_strlen(文字列,エンコーディング)
	

【書式】
substr_count(検査対象文字列,副文字列,検査開始位置,検査文字数);
【戻り値】
整数

【書式】
md5(文字列,raw_output);
【戻り値】
計算成功：ダイジェスト計算結果
計算失敗：false      

文字列の検索置換変換など

• 単純文字列検索（位置検出）
• 正規表現を用いた文字列検索（preg_match、preg_match_all）
• 正規表現を用いた文字列検索のマルチバイト文字対応（mb_ereg）
• 配列からパターンにマッチした要素を取り出す（preg_grep）
• 単純文字列置換（str_replace）
• 文字の変換、部分文字列置換（strtr）
• 正規表現を用いた文字列置換（preg_replace）
• 正規表現を用いた文字列置換のマルチバイト文字対応
• 前後から指定文字を除去（trim、rtrim、ltrim）
• 文字列比較（strcmp）
• 文字列の一部を取得（substr）
• 文字列の分割
• 大文字小文字変換
• html表示関係
• URLエンコード
• MySQLクエリ文エスケープ
• 暗号化、ハッシュ

参考文献・サイト：

• PHP: String関数 - Manual

【書式】
strpos(検索対象文字列,検索内容,開始位置)

【戻り値】
文字列が見つかった場合：見つかった位置（文字列の最初が0文字目）
見つからなかった場合：false

【書式と戻り値】
preg_match(検索パターン,検索対象文字列,結果格納配列,フラグ,検索開始位置)
検出した場合→1（整数 (int) 型）
検出しなかった場合→0（整数 (int) 型）
エラー発生→false（論理 (boolean) 型）

preg_match_all(検索パターン,検索対象文字列,結果格納配列,フラグ,検索開始位置)
検出した場合→検出した個数（整数 (int) 型）
検出しなかった場合→0（整数 (int) 型）
エラー発生→false（論理 (boolean) 型）

【例１】preg_match→パターンに一致する文字列が１つ見つかったら終わり
$a = 'カロテノイドとその産物が働いているところをPDBに登録されたいくつかの構造で見ることができる。多くのβ-カロテン分子が、光合成で光を捕らえるのに用いられる大きな光化学系で見られる。上図左に示した例はシアノバクテリアから得られた[[mom:022|光化学系I]]（PDBエントリー [[PDB:1jb0]]）である。端には橙色で示したいくつかのβ-カロテン分子が見える。レチナールはβ-カロテンの半分の大きさで、上図右に示した[[mom:027|ロドプシン]]（rhodopsin、PDBエントリー [[PDB:1f88]]）のような光感覚蛋白質で見られる。ピンク色で示したレチナールは蛋白質の内側奥深くに埋まっており、そこでリジン（lysine）アミノ酸が付加されている。';
preg_match('/\[\[mom:(.+?)\|(.+?)\]\]/',$a,$match);
print_r($match);

【実行結果】
Array
(
    [0] => [[mom:022|光化学系I]]
    [1] => 022
    [2] => 光化学系I
)

【例２】preg_match ＋ PREG_OFFSET_CAPTUREフラグ
preg_match('/\[\[mom:(.+?)\|(.+?)\]\]/',$a,$match,PREG_OFFSET_CAPTURE);
print_r($match);

【実行結果】
Array
(
    [0] => Array
        (
            [0] => [[mom:022|光化学系I]]
            [1] => 330
        )

    [1] => Array
        (
            [0] => 022
            [1] => 336
        )

    [2] => Array
        (
            [0] => 光化学系I
            [1] => 340
        )
)

【例３】preg_match_all→見つかってもその後の文字列から検索続行、最後まで
preg_match_all('/\[\[mom:(.+?)\|(.+?)\]\]/',$a,$match,PREG_PATTERN_ORDER);
print_r($match); このフラグは既定値と同じなのでなくても動作は同じ↑

【実行結果】
Array
(
    [0] => Array
        (
            [0] => [[mom:022|光化学系I]]
            [1] => [[mom:027|ロドプシン]]
        )

    [1] => Array
        (
            [0] => 022
            [1] => 027
        )

    [2] => Array
        (
            [0] => 光化学系I
            [1] => ロドプシン
        )

)

【例４】preg_match_all、フラグPREG_SET_ORDER
preg_match_all('/\[\[mom:(.+?)\|(.+?)\]\]/',$a,$match,PREG_SET_ORDER);
print_r($match);

【実行結果】
Array
(
    [0] => Array
        (
            [0] => [[mom:022|光化学系I]]
            [1] => 022
            [2] => 光化学系I
        )

    [1] => Array
        (
            [0] => [[mom:027|ロドプシン]]
            [1] => 027
            [2] => ロドプシン
        )

)
【例５】preg_match_all、フラグ PREG_OFFSET_CAPTURE  
preg_match_all('/\[\[mom:(.+?)\|(.+?)\]\]/',$a,$match,PREG_OFFSET_CAPTURE);
print_r($match); ↑既定のフラグ PREG_PATTERN_ORDER の内容に加え、見つかった場所をオクテット（バイト）値で示す値が追加される。

【実行結果】
Array
(
    [0] => Array
        (
            [0] => Array
                (
                    [0] => [[mom:022|光化学系I]]
                    [1] => 330
                )

            [1] => Array
                (
                    [0] => [[mom:027|ロドプシン]]
                    [1] => 563
                )

        )

    [1] => Array
        (
            [0] => Array
                (
                    [0] => 022
                    [1] => 336
                )

            [1] => Array
                (
                    [0] => 027
                    [1] => 569
                )

        )

    [2] => Array
        (
            [0] => Array
                (
                    [0] => 光化学系I
                    [1] => 340
                )

            [1] => Array
                (
                    [0] => ロドプシン
                    [1] => 573
                )

        )

)
	

【書式】
mb_ereg(検索パターン,検索対象文字列,結果格納変数)
mb_ereg_match(検索パターン,検索対象文字列)
	

cat test.php
<?php
$str = 'ふらいぱん';
echo $str." →「ぱん」で検索 ... ";
if (mb_ereg_match('ぱん',$str)) {
  echo "Hit!\n";
} else {
  echo "Not Hit!\n";
}
echo $str." →「.*ぱん」で検索 ... ";
if (mb_ereg_match('.*ぱん',$str)) {
  echo "Hit!\n";
} else {
  echo "Not Hit!\n";
}
?>
php test.php
ふらいぱん →「ぱん」で検索 ... Not Hit!
ふらいぱん →「.*ぱん」で検索 ... Hit!

function mb_ereg_match_all($pattern,$subject)
{
  #- マルチバイト文字列検索設定（失敗したらfalseを返して終了）
  if (!mb_ereg_search_init($subject,$pattern)) {
    return false;
  } else {
    #- 結果格納配列変数初期値セット（空配列）
    $matches = array();
    #- 見つからなくなるまで検索を繰り返す
    while ($match = mb_ereg_search_regs()) {
      $matches[] = $match;
    }
    return $matches;
  }
}

$ cat test.php
<?php
$str = '我々と最も近縁な[哺乳類 ほにゅうるい]のミオグロビンは我々のものとかなり似ているが、[爬虫類 はちゅうるい]や魚類になると分化からより長い時間が経っており違いはより大きくなっている。';
preg_match_all('/[^\[]?[\[]([^\[]+?) +?([^\[]+?)[\]][^\]]?/',$str,$match);
$match2 = mb_ereg_match_all('[^\[]?[\[]([^\[]+?) +?([^\[]+?)[\]][^\]]?',$str);
echo "Search Items (preg_match_all):\n";
echo var_dump($match);
echo "Search Items (mb_ereg_match_all):\n";
echo var_dump($match2);
?>
$ php test.php
Search Items (preg_match_all):
array(3) {
  [0]=>
  array(2) {
    [0]=>
    string(32) "�[哺乳類 ほにゅうるい]�"
    [1]=>
    string(32) "�[爬虫類 はちゅうるい]�"
  }
  [1]=>
  array(2) {
    [0]=>
    string(9) "哺乳類"
    [1]=>
    string(9) "爬虫類"
  }
  [2]=>
  array(2) {
    [0]=>
    string(18) "ほにゅうるい"
    [1]=>
    string(18) "はちゅうるい"
  }
}
Search Items (mb_ereg_match_all):
array(2) {
  [0]=>
  array(3) {
    [0]=>
    string(36) "な[哺乳類 ほにゅうるい]の"
    [1]=>
    string(9) "哺乳類"
    [2]=>
    string(18) "ほにゅうるい"
  }
  [1]=>
  array(3) {
    [0]=>
    string(36) "、[爬虫類 はちゅうるい]や"
    [1]=>
    string(9) "爬虫類"
    [2]=>
    string(18) "はちゅうるい"
  }
}

【書式】
preg_grep(正規表現パターン,配列,フラグ)
【戻り値】
[配列]指定した正規表現パターンにマッチするものを要素とする配列。配列キーは配列のまま。
	

【例】
$ cat test.php
<?php
$array = array('tiger','leopard','snow leopard','lion','mountain lion','mavericks','yosemite');
echo "【元配列】";
print_r($array);
echo "【leopardを含む】";
print_r(preg_grep('/leopard/',$array));
?>
$ php test.php
【元配列】Array
(
    [0] => tiger
    [1] => leopard
    [2] => snow leopard
    [3] => lion
    [4] => mountain lion
    [5] => mavericks
    [6] => yosemite
)
【leopardを含む】Array
(
    [1] => leopard
    [2] => snow leopard
)
	

【書式】
str_replace(検索内容,置換内容,検索対象,置換数格納先)
【戻り値】
置換後の文字列または配列。
	

【書式】文字単位での置換
strtr(置換対象文字列,置換対象文字群,置換後文字群);
【戻り値】
変換後の文字列
	

【書式】文字列単位での置換
strtr(置換対象文字列,置換対応群);
【戻り値】
変換後の文字列
但し、置換対応群の中に空文字のキーがあるとfalseを返す。
	

【例】
$ cat test.php
<?php
$str = "abccbadef";
echo $str."\n";
echo strtr($str,"abc","123")."\n";
echo strtr($str,"abc","12345")."\n";
echo strtr($str,"abcde","123")."\n";
echo strtr($str,array("abc"=>"123","ab"=>"xxx"));
?>
$ php test.php
abccbadef
123321def # a→1、b→2、c→3 の置換
123321def # 置換後文字の4,5は無視
123321def # 置換前文字のd,eは無視
123cbadef # abc→123 の置換、ab→xxxの置換はabcより短く優先度下なので適用されない
	

【書式】
preg_replace(検索パターン,置換パターン,検索置換対象,置換上限回数,置換数格納先);
【戻り値】
検索置換対象が文字列→文字列
検索置換対象が配列→配列

文字列または配列の各要素の扱い
検索パターンにマッチした→置換後の値
検索パターンにマッチしない→検索置換対象そのまま

エラーがあった場合→NULL
	

【例１】
＜script＞
$string = '$pname はでんぶんを加水分解する酵素の１つです。';
$pattern = '/¥$pname/';
$replacement ='アミラーゼ';
echo preg_replace($pattern,$replacement,$string);
＜結果＞
アミラーゼ はでんぶんを加水分解する酵素の１つです。

【例２】
＜script＞
$string = '右図上部に示したのはノイラミニダーゼ（[[PDB:1nn2]]）で、４つの同じサブユニットが四角く並んでいる。'
$pattern = '/¥¥[¥[(PDB):([0-9a-z]{4})¥]¥]/';
$replacement = '$1エントリー:<a href="http://pdbjs8.pdbj.org/xPSSS/xPSSSSearch?search_type=pdbid_search&query=$2">$2</a>'
echo preg_replace($pattern,$replacement,$string);
＜結果＞
右図上部に示したのはノイラミニダーゼ（PDBエントリー:<a href="http://pdbjs8.pdbj.org/xPSSS/xPSSSSearch?search_type=pdbid_search&query=1nn2">1nn2</a>）で、４つの同じサブユニットが四角く並んでいる。
	

【書式】
mb_ereg_replace(検索パターン,置換パターン,置換対象文字列,オプション);
	

【例】
<?php
echo "<html>\n<body>\n";
$a = "あいうえお.jpg あいうえお.png あかさたな.jpg";

echo "<p>\$a は「" . $a . "」です。</p>\n";
echo "<p>「あ」で始まり、「.jpg」で終わる場合、「あ」を「か」に置換します。</p>\n";
echo "<p>結果は「" . mb_ereg_replace('あ([^ ]+?\.jpg)','か\1',$a) . "」です。</p>\n";
echo "</body>\n</html>\n";
?>

※パターンについて
[^ ]: 空白（ ）以外
+?\.jpg: 1文字以上最短マッチ（最初の .jpg でヒット範囲は停止）

【出力結果】
$a は「あいうえお.jpg あいうえお.png あかさたな.jpg」です。
「あ」で始まり、「.jpg」で終わる場合、「あ」を「か」に置換します。
結果は「かいうえお.jpg あいうえお.png かかさたな.jpg」です。
	

【書式】
trim(文字列,削除対象文字);
ltrim(文字列,削除対象文字);
rtrim(文字列,削除対象文字);
【戻り値】
指定文字削除済み文字列

【書式】
substr(処理対象文字列, 開始位置, 長さ)
mb_substr(処理対象文字列, 開始位置, 長さ)

【例１】
$rest = substr("abcdef", 0, 3);     → "abc" を返す（正数は先頭からのカウント、先頭文字が0番目）
$rest = substr("abcdef", 3);     → "def" を返す（第2引数がない場合は最後まで）
$rest = substr("abcdef", -1);    → "f" を返す（負数は末尾からのカウント、最後の文字が-1番目）
$rest = substr("abcdef", -2);    → "ef" を返す
$rest = substr("abcdef", -3, 1); → "d" を返す
$rest = substr("abcdef", 0, -1);  → "abcde" を返す
$rest = substr("abcdef", 2, -1);  → "cde" を返す
$rest = substr("abcdef", 4, -4);  → "" を返す
$rest = substr("abcdef", -3, -1); → "de" を返す

【例２】UPDATE datatable SET name="jiro",species="shiba",sex="male" WHERE name="taro" を生成
$datalist = array('name'=>'jiro,'species'=>'shiba','sex'=>'male');
$qstr = 'UPDATE datatable SET ';
foreach($datalist as $key=>$value) { 
  $qstr = $qstr . $key . '="' . $value . '",';
}
$qstr = substr($qstr,0,-1) . ' WHERE name="' . 'taro' . '"';
↑最後の１文字（カンマ）を除去してから WHERE...を追加している

【例３】@より前の部分を取り出す
<?php
$address = "user@mail.hoge.com";
$local = substr($address,0,strpos($address,'@'));
↑0番目（先頭文字）からn文字取り出す
　n='@'の場所、先頭を0として数えているのでn文字取り出すと丁度@の直前文字までになる
　strposコマンドも参照のこと
echo $local;
?>
user
	

【例１】
$str = "This is a pen.\n";
echo $str;
$str = strtoupper($str);
echo $str;
$str = strtolower($str);
echo $str;
$str = ucfirst($str);
echo $str;
$str = ucwords($str);
echo $str;

【結果】
This is a pen.
THIS IS A PEN.
this is a pen.
This is a pen.
This Is A Pen.
	

【書式】
htmlspecialchars(文字列,フラグ,文字セット,double_encode)
【戻り値】
変換後の文字列
但し、文字列中に

【出展】PHP Manual: htmlspecialchars
<?php
function htmlspecialchars_deep($mixed, $quote_style = ENT_QUOTES, $charset = 'UTF-8')
{
  if (is_array($mixed)) {
    foreach($mixed as $key => $value) {
      $mixed[$key] = htmlspecialchars_deep($value, $quote_style, $charset);
    }
  } elseif (is_string($mixed)) {
    $mixed = htmlspecialchars(htmlspecialchars_decode($mixed, $quote_style), $quote_style, $charset);
  }
  return $mixed;
}
?>

$mixed: 配列または文字列（必須）
$quote_style: 引用符の扱い（任意、無指定時の既定値は引用符も全てエスケープ）
$charset: 文字コード（任意、無指定時の既定値はUTF-8）
	

【例】PHP 5.3.0以降の場合
$ cat test.php
<?php
$array = array(' -_.~','!"#$%&\'()*+,/',
             ':;<=>?@',
             '[\]^`{|}',
             '¥');
foreach ($array as $val) {
  echo $val."\n";
  echo "  urlencode   : ".urlencode($val)."\n";
  echo "  rawurlencode: ".rawurlencode($val)."\n";
}
?>
$ php test.php
 -_.~
  urlencode   : +-_.%7E
  rawurlencode: %20-_.~
!"#$%&'()*+,/
  urlencode   : %21%22%23%24%25%26%27%28%29%2A%2B%2C%2F
  rawurlencode: %21%22%23%24%25%26%27%28%29%2A%2B%2C%2F
:;<=>?@
  urlencode   : %3A%3B%3C%3D%3E%3F%40
  rawurlencode: %3A%3B%3C%3D%3E%3F%40
[\]^`{|}
  urlencode   : %5B%5C%5D%5E%60%7B%7C%7D
  rawurlencode: %5B%5C%5D%5E%60%7B%7C%7D
¥
  urlencode   : %C2%A5
  rawurlencode: %C2%A5

【MySQL】
mysql_real_escape_string(文字列,接続ハンドル)

【MySQLi オブジェクト指向型】
mysqli::real_escape_string(文字列)

【MySQLi 手続き型】
mysqli_real_escape_string(接続ハンドル,文字列)

【戻り値】
エスケープ済みの文字列
	

配列関係の文字列処理

• 配列を整形して出力（print_r）
• 配列の各要素を指定文字列でつなぐ（implode）
• 指定文字列で区切ってそれぞれを配列に格納（explode）→文字列の分割参照

【書式】
implode(つなぎ文字列,配列)

【例】
$array = array('a','b','c');
$comma_separated = implode(",",$array);
echo $comma_separated;
a,b,c
	

マルチバイト関数

マルチバイト関数を利用するには、mbstring関数を有効にする必要がある。インストール後の設定参照。

• 文字エンコーディングの変換（mb_convert_encoding）
• MIMEヘッダの文字列をエンコードする（mb_encode_mimeheader）
• 言語設定値の取得、設定（mb_language）
• 内部エンコーディング設定値の取得、設定（mb_internal_encoding）

【書式】
mb_convert_encoding(文字列,変換後文字エンコーディング名,変換前文字エンコーディング)

【例】Shift JISに変換
$str = mb_convert_encoding($str, "SJIS");
	

mb_encode_mimeheader(文字列,文字列のエンコーディング,MIMEエンコーディング方式);
	

【書式１】現在の言語設定情報の取得
mb_language
→戻り値は言語名（言語設定が事前に行われている場合）または false
【書式２】現在の言語設定情報を変更
mb_language(エンコーディング指定文字列)
→戻り値はtrue（指定が有効な値であった場合）またはfalse
	

【書式１】現在の内部文字エンコーディング情報の取得
mb_internal_encoding
→戻り値は現在の内部エンコーディング名
【書式２】現在の内部文字エンコーディング情報の変更
mb_language(エンコーディング指定文字列)
→戻り値はtrue（設定に成功した場合）またはfalse（設定に失敗した場合）
	

参考文献・サイト：

• マルチバイト文字列関数 (mbstring)
• PHP: マルチバイト文字列 - Manual

現在時刻を得る（time）

timeは、現在時刻をUNIXタイム（1970年1月1日 00:00:00 GMTからの積算秒数）で返す。

【書式】
time()
      

時刻を整形して出力（date）

dateは、

【書式】
date(書式指定,UNIXタイム値)

書式指定には定義済み定数または書式文字列を指定する。UNIXタイム値（1970年1月1日 00:00:00 GMTからの積算秒数）を指定しない場合の既定値は現在時刻（＝time()の戻り値）。

【例】
# UNIXタイム0＝1970年1月1日 0:00:00(UTC)
$ php -r 'echo date("Y/m/d H:i:s O(T)",0)."\n";'
1970/01/01 09:00:00 +0900(JST)
# 現在時刻
$ php -r 'echo date("Y/m/d H:i:s O(T)")."\n";'
2013/08/27 15:31:19 +0900(JST)

指定日時に対応するUNIXタイムスタンプを得る（mktime）

mktimeは、指定日時に対応するUNIXタイムスタンプ（1970年1月1日 00:00:00からの積算秒数）を返す。引数は後ろから順に省略可能で、省略された値はローカルの日付時刻値に従った現在の値にセットされる。引数が不正であった場合は false が返る（PHP 5.1以降の場合、それより前は -1）。PHP 5.1以降で全ての引数を省略すると E_STRICT notice を返すようになったので、現在時刻のUNIXタイムスタンプを得るにはtimeを使うこと。

【書式】
mktime(時,分,秒,月,日,年)
→整数（UNIXタイムスタンプ）または false（PHP 5.1以降、それより前は-1）
      

時

整数値。0-23は指定日の当日、負数は指定日の0時から遡った時間、24以上は翌日以降の該当時間を表す。指定がない場合の既定値は現在の時（date('H')の戻り値）だが、PHP 5.1以降では全ての引数を省略することはできない。

分

整数値。0-59は指定時内の分、負数は指定時の0分から遡った時間、60以上は次の時以降の該当分を表す。指定がない場合の既定値は現在の分（date('i')の戻り値）。

秒

整数値。0-59は指定分内の秒、負数は指定分の0秒から遡った時間、60以上は次の分以降の該当秒を表す。指定がない場合の既定値は現在の秒（date('s')の戻り値）。

月

整数値。前年末から数えた月数。1-12は指定年内の月と一致。0 は前年12月、負数は前年12月から遡った月、13以上は翌年以降の該当月を表す。指定がない場合の既定値は現在の月（date('n')の戻り値）。

日

整数値。前月末から数えた月数。指定月内に存在する日と同じ値については月内の日、0 は前月末日、、負数は前月末日から遡った日、指定月の末日より大きな値は翌月以降の該当日を表す。指定がない場合の既定値は現在の日（date('j')の戻り値）。

年

整数値。2,3桁または4桁で西暦を指定。2,3桁の場合、0-69は2000-2069年、70-100は1970-2000年を表す。4桁の場合、1901-2038が指定可能。指定がない場合の既定値は現在の年（date('Y')の戻り値）。

【例】現在から72時間前
$ cat test.php
#!/usr/bin/php
<?php
date_default_timezone_set('Asia/Tokyo'); # PHP 5.1以降、既定時間帯の設定は必須（php.iniに設定していない場合）
echo date('Y/m/d H:i:s',mktime(date('H')-72));
echo " (UNIX epoch: ".mktime(date('H')-72).")\n";
?>
$ php ./test.php
2011/05/10 13:04:39 (UNIX epoch: 1305000279)

【例】前月の年月
$ php -r "date_default_timezone_set('Asia/Tokyo');echo 'Today is '.date('Y/m/d').\"\n\";"
Today is 2011/08/01
$ php -r "date_default_timezone_set('Asia/Tokyo');echo 'The last month is '.date('Y/m',mktime(0,0,0,date('m')-1)).\"\n\";"
The last month is 2011/07
      

既定のタイムゾーン設定（date_default_timezone_set）

date_default_timezone_setは、日付/時刻関数で 使用されるタイムゾーンの既定値を設定する。PHP初期設定ファイルのdate.timezoneに設定しても同じ（記述例：date.timezone = 'Asia/Tokyo'）。PHP 5.1.0 以降、タイムゾーンを 正しく設定せずに日付/時刻関数をコールすると E_NOTICE が発生し、システムの設定や TZ 環境変数を 使用すると E_WARNING エラーが発生するようになっている。

【書式】
date_default_timezone_set(タイムゾーン識別子);
【戻り値】
正しいタイムゾーン識別子→true
正しくないタイムゾーン識別子→false

【例】
date_default_timezone_set('Asia/Tokyo');

# 既定タイムゾーンの設定がないと、警告が出る
$ cat test.php
#!/usr/bin/php
<?php
$today = date('Y年n月j日');
echo <<< _STR_
今日は${today}です。

_STR_
;
?>
$ php test.php
Warning: date(): It is not safe to rely on the system's timezone settings. You are *required* to use the date.timezone setting or the date_default_timezone_set() function. In case you used any of those methods and you are still getting this warning, you most likely misspelled the timezone identifier. We selected 'Asia/Tokyo' for 'JST/9.0/no DST' instead in /Library/Webserver/Documents/kw1/jv/test/test.php on line 3
今日は2015年1月19日です。
# 既定タイムゾーンの設定を追加すると、警告が出なくなった
$ cat test2.php
#!/usr/bin/php
<?php
date_default_timezone_set('Asia/Tokyo');
$today = date('Y年n月j日');
echo <<< _STR_
今日は${today}です。

_STR_
;
?>
$ php test2.php
今日は2015年1月19日です。

型判定・値の比較

書式列のリンク先はPHP Manualの各ページ。

$src = array(1,0,0,0,1,0,0,0,1,0,0,0);
$dest = array(1,0,0,0,1,0,0,0,1,0,0,0);
$src == $dest;

型変換

前に"(型)" と記すことで型を宣言（型キャスト）できる。

$a = 100; // $a は整数
$b = (string) $a; // $b は文字列
      

利用できる型キャストは以下の通り。

intvalは、指定された文字列を整数に変換する。

【書式】
intval(変数名,基数);
      

戻り値は以下の通り。

英字を含む引数に指定した場合、「数値または.」＋「e/E」＋「数値または.」の形式なら数値とみなされる。基数に10より大きい値を指定した場合で、該当値に当たる文字があれば数値とみなされる（例：16進数のA~F）。それ以外の英字は0となる。

【例】
intval(42); → 42
intval(4.2); → 4
intval('42'); → 42
intval('+42'); → 42
intval(042); → 42
intval('042'); → 42
intval('42',8); → 34、8進数の"42"が10進数の整数値に変換される
intval('0x1f'); → 0、英字を含むと原則として0になる
intval('0x1f',16); → 31、基数を指定するとa〜fも数字文字列とみなされる
intval('1f',16); → 31、基数16を指定すれば"0x"を前に付けなくても16進数とみなされる
intval('01f',16); → 31、頭に空桁があっても同じ

なお、intvalは出力形式を指定できないので、出力形式を指定したい場合はsprintfを用いる。

バイナリ値を16進数値に変換するにはbin2hexを用いる。

逆16進数値をバイナリ値に変換するにはhex2binを用いる。

変数の操作と条件指定で繰り返し処理を行う（for）

forは指定回数繰り返し処理を行うのに使える。

【書式】
for (式1;式2;式3) {
  文
}
      

式1は繰り返し処理全体の開始時、無条件に実行される。 式2は各回繰り返し処理開始時に評価され、結果がTrueなら文が実行される。Falseなら繰り返し処理は終了する。 式3は各回繰り返し処理後、無条件に実行される。

【例】
for ($i = 1; $i <= 10; $i++) {
  echo $i . " ";
}
【結果】
1 2 3 4 5 6 7 8 9 10
      

まず最初に「$i = 1」（$i に 1 を代入する）が実行されて繰り返し処理が開始される。 「$i <= 10」（$i は 10 以下）の評価結果はTrueなので「$i . " "」（$i と空白を出力）が実行される。その後「$i++」（$i に 1 を足す）が実行されて次のループに進む。10回ループが実行され $i が 11 になった時、$i <= 10がFalseになるので繰り返し処理は終了する。

配列要素全体に対して処理する（foreach）

foreachは配列の全要素に対して処理を行う。

【書式】
foreach (配列変数 as 一時変数名)
foreach (配列変数 as 一時変数キー名=>一時変数名)

【例】
$a = array(1,2,3);
foreach ($a as $item) {
  echo $item * 2 . ",";
}
2,4,6
foreach ($a as $key=>$item) {
  $b[$key] = $item * 2;
}
print_r($b);
Array
(
  [0] => 2
  [1] => 4
  [2] => 6
)
      

条件を満たす間繰り返す（while,do while）

whileは最初に条件判定を行い条件を満たしている間処理を繰り返す。do-whileは最低１回は処理を行ってから条件判定を行う。

【書式】
while (条件) {
  処理
}
do {
  処理
} while (条件);

【例】
$i = 1;
while ($i <= 10) { ←$iが10以下である間は繰り返す
  echo $i++ . " "; ←$iを表示してから1を加える（→演算参照）
}
1 2 3 4 5 6 7 8 9 10 $i=10の処理→次は$i=11なので処理されず終了

do {
  echo $i++ . " ";
} while ($i <= 10); ←$iが10以下である間は繰り返す
11 まず処理実行→その後判定→$i=12>10なので条件に合わず終了
      

ループを出る（break）

breakは for, foreach, while, do-while, switch 構造の実行を終了する。引数を省略すると直近のループ構造のみを出る（つまり既定値は1）。

【書式】
break ループ構造を抜ける段数

ループ構造を抜ける段数

（自然数）ループ構造を抜ける段数を自然数で指定する。値の指定がない場合の既定値は1。PHP 5.4.0以降、0は指定できなくなった（それまでは1と同じ意味に解釈されていた）。また、同バージョンより変数は指定できなくなった。

$_SERVER

$_SERVERの各キーと対応する値の内容、例を以下に示す。

スクリプトファイル名だけを取り出すにはbasename関数を用いる。

スクリプトをコマンドラインから実行する場合に関わる定義済み変数（$argv、$argc）についてはコマンドラインからの実行 - 引数の指定と参照を参照のこと。

$_GET、$_POST

それぞれ、GETメソッド、POSTメソッドで送られたキーと値のセットが配列として格納される。

$_FILES

フォームで送信されたファイルに関する情報が格納される。詳細はファイルのアップロードに関する情報参照を参照のこと。

変数の割り当て解除（unset）

unsetは変数の割り当てを解除する。

【書式】
unset(変数名,変数名...)

【例】
$ cat test.php
<?php
$array = array(1=>'Hydrogen',2=>'Helium',3=>'Lithium',4=>'Beryllium',5=>'Boron',6=>'Carbon');
var_dump($array);
unset($array[1]);
var_dump($array);
?>
$ php test.php
array(6) {
  [1]=>
  string(8) "Hydrogen"
  [2]=>
  string(6) "Helium"
  [3]=>
  string(7) "Lithium"
  [4]=>
  string(9) "Beryllium"
  [5]=>
  string(5) "Boron"
  [6]=>
  string(6) "Carbon"
}
array(5) {
  [2]=>
  string(6) "Helium"
  [3]=>
  string(7) "Lithium"
  [4]=>
  string(9) "Beryllium"
  [5]=>
  string(5) "Boron"
  [6]=>
  string(6) "Carbon"
}

変数の設定状況判定（isset）

issetは変数の設定状況を判定する。「セットされ、NULLではない」ならtrue、そうでないならfalseを返す。複数の変数を指定した場合、前から順に判定してfalseとなる変数があった時点でfalseを返し、最後まで全てtrueならtrueを返す。

【書式】
isset(変数名,変数名...)
      

変数が空であるかを調べる（empty）

emptyは変数が空であるかを調べる。変数が存在しないか、またはfalseと判定される値がセットされている場合に空とみなされる（変数が存在しなくてもエラーにはならない）。「 !isset($var) || $var == false」の判定をやっているのと同じ。

【書式】
empty(変数);

【戻り値】
空と判定（変数が存在しない場合も含む）→true
空ではない（変数が存在し、かつその値が空と判定されるような値ではない）→false

空と判定される値は以下のとおり。

• ""（空文字列）
• 0（整数の0）
• 0.0（浮動小数点の0）
• "0"（文字列の0）
• NULL
• FALSE
• array()（空配列）
• $var（宣言されてはいるが値が設定されていない変数）

配列の定義

$配列変数名[キー値] の形でキー毎に個別に代入するか、またはarrayを使って一度に指定する。

【例１】arrayを使って複数の要素を一度に定義
$a = array('abc','def','123');
foreach ($a as $tmp) {
print "$tmp¥n";
}
【結果１】
abc
def
123

【例２】配列内の個別要素を定義するには、変数名[キー値]を用いる。値は非負整数または文字列。
$b[0] = "ghi";
$b[3] = "def";
$b[] = "xyz"; キー値を省略すると既存最大キー値（3）＋１が自動的に採用される
print "$b[0]¥n";
print "$b[3]¥n";
print "$b[4]¥n¥n";
print_r $b;
【結果２】
ghi
def
xyz

Array
  (
  [0] => ghi
  [3] => def
  [4] => xyz
)

【例３】連想配列（キー値が数値ではない配列）の設定
$c = array('apple' => 'red', 'banana' => 'yellow', 'chocolate' => 'brown');
print_r $c;
Array
(
  [apple] => red
  [banana] => yellow
  [chocolate] => brown
  )
      

配列要素の追加と削除

特定の要素を削除するのはunset。配列添字ふり直しはarray_values（配列から全ての値を取り出し、数値添字をつけた配列を返す）。

【書式】
unset(変数名, 変数名...);
array_values(配列);
      

$a = array (2 => 'two',
            3 => 'three');
print_r($a);
Array
(
  [2] => two
  [3] => three
)

array_push(4 => 'four', 5 => 'five'); ←最後に要素追加
print_r($a);
Array
(
  [2] => two
  [3] => three
  [4] => four
  [5] => five
)

$a[] = 'six'; ※要素を1個だけ追加するなら、この方が軽い
print_r($a);
Array
(
  [2] => two
  [3] => three
  [4] => four
  [5] => five
  [6] => six
)

array_pop($a) ←最後に要素を1個削除
print_r($a);
Array
(
  [2] => two
  [3] => three
  [4] => four
  [5] => five
)

array_unshift($a,'zero','one') ←先頭に要素追加し、添字番号ふり直し（文字列キーの要素はそのまま）
print_r($a);
Array
(
  [0] => zero
  [1] => one
  [2] => two
  [3] => three
  [4] => four
  [5] => five
)

array_shift($a) ←先頭から1個要素削除し、添字番号ふり直し（文字列キーの要素はそのまま）
print_r($a);
Array
(
  [0] => one
  [1] => two
  [2] => three
  [3] => four
  [4] => five
)

unset($a[3]) ←指定の要素を削除（添字はそのまま）
print_r($a);
Array
(
  [0] => one
  [1] => two
  [2] => three
  [4] => five
)
※unsetは配列用の関数ではなく、変数一般を削除する関数

$a = array_values($a) ←添字番号割り振り直し
print_r($a);
Array
(
  [0] => one
  [1] => two
  [2] => three
  [3] => five
)
      

配列内の要素数を数える

配列内の要素数を数えるにはcount関数を用いる。

【書式】
count(配列,カウントモード)

【戻り値】
数えられるオブジェクト→要素数（整数）
数えられないオブジェクト→1（整数）
NULL→0（整数）
未セット→0（整数）※isset関数を併用すると、NULLなのか未セットなのかは区別可能

カウントモードに0またはCOUNT_NORMALを指定した場合は最上階層要素だけ数える。1またはCOUNT_RECURSIVEを指定した場合は、全階層の要素数を数える。

【例】
<?php
$a = array('a','b','c');
$b = array(array('a','b','c'), array('1','2','3'));
echo '$a: ' . count($a); . "¥n";
echo '$b: ' . count($a); . "¥n";
echo '$b(all): ' . count($a,COUNT_RECURSIVE); . "¥n";
?>

【出力】
$a: 3
$b: 2
$b(all): 8

なお、第1引数にテキストファイル名を指定した場合、テキストファイルの行数を返す。

【書式】
count(テキストファイル名)

配列中で値があるか調べる

in_arrayは配列要素中に指定した値があるかどうか調べる。あればtrue、それ以外はfalseを返す。

【書式】
in_array(探索値,配列,strict)
【戻り値】真偽値（bool）
探索値が配列要素中にあった：true
探索値が配列要素中になかった：false

探索値

データ型：混合型（object|resource|array|string|int|float|bool|null、PHP 8.0.0以降で利用可能）

探す値。文字列の場合、大文字小文字は区別して比較される。

配列

データ型：配列（array）

探索先となる配列

strict

データ型：真偽値（bool）

既定値：false

trueを指定すると型も一致しているかを確認する。

array_key_existsは配列中に指定したキーがあるかどうか調べる。あればtrue、なければfalseを返す。

【書式】
array_key_exists(探索値,配列)
【戻り値】真偽値（bool）
キーが見つかった:true
キーが見つからない:false

探索値

データ型：文字列型（string）または整数型（int）

探すキー値。配列添字として使えるすべての値を指定可能。

配列

データ型：配列（array）

探索先となる配列

issetはnull値を持つ配列キーは返さないが、このarray_key_existsはtrueを返す。

array_key_existsは最初のレベルのキーだけを探索する。多次元配列の第2階層以降にあるキーは探索対象外。

array_searchはin_arrayと似ているが、戻り値が「最初に見つかった値のキー」である点が異なる。見つからない場合 false を返すのは同じ。

【書式】
array_search(探索値,配列,strict)
【戻り値】整数（int）、文字列（string）またはfalse
値が見つかった：要素のキー
値が見つからない：false

全てのマッチした値に対するキーを得るには、array_keys 関数で 検索値オプションを指定する。

配列のキーを得る

array_keysを用いる（配列キーを配列で得られる）。

【書式】
array_keys(配列,検索値,型判定);
      

検索値

検索値を値に持つ要素のキーのみが返される。指定がない場合の既定動作は全ての検索値が対象（配列の全要素のキーが返される）。

型判定

trueを指定すると型も含めて一致しているかどうかの判定（===）が行われる。falseを指定すると型判定までは行わない通常の比較（==）が行われる。指定がない場合の既定値は false。

【例】
$airports = array('KIX'=>'関西国際空港',
                  'ITM'=>'伊丹空港',
                  'UKB'=>'神戸空港',
                  'SHM'=>'南紀白浜空港',
                  'TKG'=>'コウノトリ但馬空港');
$cords = array_keys($airports);
print_r($cords);

＜出力結果＞
Array
(
  [0] => KIX
  [1] => ITM
  [2] => UKB
  [3] => SHM
  [4] => TKG
)
      

配列のキーをランダムに取り出す（array_rand）

array_randは配列から一つ以上の要素をランダムに取り出し、取り出した要素キーを返す。取り出す要素の数が1つである場合はそのキー値、複数ある場合は各キー値を要素とする配列を返す。配列の中にある要素数より多くの要素を取り出そうとすると E_WARNING レベルのエラーが発生し、NULL を返す。

【書式】
array_rand(配列,取り出す要素数);

【戻り値】
取り出す要素が1つ→文字列：そのキー値
取り出す要素が複数→配列：各キー値を要素とする配列
配列の中にある要素数より多くの要素を取り出そうとした時→NULL

配列

配列：入力の配列

取り出す要素数

整数：取り出す要素の数。指定がない場合の既定値は1。

【例】
$ cat test.php
<?php
$array = array(1=>'Hydrogen',2=>'Helium',3=>'Lithium',4=>'Beryllium',5=>'Boron',6=>'Carbon');
echo '1つ取り出し：';
var_dump($array[array_rand($array)]);
echo '2つ取り出し：';
foreach (array_rand($array,2) as $key) {
  var_dump($array[$key]);
}
?>
$ php test.php
1つ取り出し：string(9) "Beryllium"
2つ取り出し：string(8) "Hydrogen"
string(6) "Carbon"

キーと値を入れ替える（array_flip）

array_flipはキーを値を入れ替えた配列を返す。キーが整数型（integer）または文字列型（string）である必要があり、そうでないキーを持つキーと値の組については入れ替えずそのままになる？ またある値が複数出現した場合、最後に出現した値がキーとして採用され、その他の値は失われる。戻り値はキーと値の反転に成功した場合はその配列、失敗した場合はNULL。

array_flip(配列);
      

配列要素の並べ替え

参考：PHP: 配列のソート - Manual

戻り値はいずれも並べ替えに成功した場合はtrue、失敗した場合はfalse。

なお、これらの並べ替え関数はマルチバイト文字には有効ではない（文字単位ではなくバイト単位で判断されるよう）。 対応策として、uniord（引数文字に対応する文字コードを返す関数ordのマルチバイト対応版）をユーザ定義関数として定義しておき、比較関数として以下のような関数を定義する（以下の例において長音記号は無視して判定している）。

function mbcmp($a,$b)
{
  #= エンコーディング設定
  $encode = 'UTF-8';
  #== 短い方の文字の長さを取得し、短い方が前と仮判定
  #- $a の方が短い場合
  if (strlen($a) < strlen($b)) {
    $len = strlen($a);
    $cmp = -1;
  #- $a の方が長い場合
  } else if (strlen($a) > strlen($b)) {
    $len = strlen($b);
    $cmp = 1;
  #- 同じ長さ→$aが前とする
  } else {
    $len = strlen($a);
    $cmp = 0;
  }

  #== 変数定義
  $i = 0; #- チェック位置（最初の文字が0）
  $dash = array('a'=>0, 'b'=>0); #- 長音記号数
  $flg = true; #- チェック継続フラグ（falseになると判定終了）
  #== チェック
  while ($flg !== false) {
    #- 前の長音記号チェック（長音記号なら$dash['a']に1加算）
    if (mb_substr($a,$i+$dash['a'],1,$encode) == "ー") {
      $dash['a']++;
    }
    #- 後の長音記号チェック（長音記号なら$dash['b']に1加算）
    if (mb_substr($b,$i+$dash['b'],1,$encode) == "ー") {
      $dash['b']++;
    }
    #- i-1文字目（長音記号はカウントせず）が同じ
    if (mb_substr($a,$i+$dash['a'],1,$encode) == mb_substr($b,$i+$dash['b'],1,$encode)) {
      #- チェック位置を次に
      $i++;
      #- 短い方の最後まで到達（短い方＝長い方の前部）→短い方が前
      if ((($cmp <= 0) and ($i+$dash['a'] >= $len)) or (($cmp > 0) and ($i+$dash['b'] >= $len))) {
	$flg = false;
      }
    #- i-1文字目が違う
    } else {
      #- $a の($i-1)文字目の文字コード
      $code_a = uniord(mb_substr($a,$i+$dash['a'],1,$encode));
      #- $b の($i-1)文字目の文字コード
      $code_b = uniord(mb_substr($b,$i+$dash['b'],1,$encode));
      #- $a の文字コードの方が小さい場合→$aが前
      if ($code_a < $code_b) {
	$cmp = -1;
      #- $b の文字コードの方が小さい場合→$bが前
      } else if ($code_a > $code_b) {
	$cmp = 1;
      }
      $flg = false;
    }
  }
  return $cmp;
}
      

キーの割り振り直し（array_values）

array_valuesは配列から全ての値を取り出し、数値をキーとする配列を返す。

【書式】
array_values(配列);
      

【例】
<?php
$a = array (1 => 'one',
            '二' => 'two',
            3 => 'three',
            'четыре' => 'four');
$b = array_values(配列);
print_r($a);
print_r($b);
?>

「実行結果」
Array
(
    [1] => one
    [二] => two
    [3] => three
    [четыре] => four
)
Array
(
    [0] => one
    [1] => two
    [2] => three
    [3] => four
)
      

配列の重複要素を削除

array_uniqueは、配列の各要素の値をチェックし、重複した値を取り除いた配列を返す。同じキーを持つ配列要素が存在した場合、先に登場した方が残され、後に登場する方が捨てられる。型の扱いは既定では全て文字列に変換して比較される（後述のソートフラグオプション参照）。

【書式】
array_unique(配列,ソートフラグ);
【戻り値】
（配列）処理済の配列
      

ソートフラグ

指定できる値と内容は以下の通り。キャスト指定の括弧内にタブ、スペースなどを含んでもよい（無視される）。

値	比較式	内容
SORT_REGULAR	$変数1 === $変数2	そのままのデータ型で型も含めて比較。但し文字と数値が表記上同じなら型が違っても同じとみなされるよう。
SORT_NUMERIC	(float) $変数1 === (float) $変数2	数値として比較
SORT_STRING	(string) $変数1 === (string) $変数2	文字列として比較（これが既定値）
SORT_LOCALE_STRING	(string) $変数1 === (string) $変数2	現在のロケール（地域設定）に基づき文字列として比較

【例】
<?php
$input = array("a" => "green", "red", "b" => "green", "blue", "red");
$result = array_unique($input);
print_r($input);
print_r($result);
?>
↓結果
Array
(
    [a] => green
    [0] => red
    [b] => green # キー"a"に同じ値があるので除去対象
    [1] => blue
    [2] => red # キー"0"に同じ値があるので除去対象
)
Array
(
    [a] => green
    [0] => red
    [1] => blue
)

【例】
<?php
$input = array(4, "4", "3", 4, 3, "3","3.0");
var_dump($input);
var_dump(array_unique($result,SORT_STRING));
var_dump(array_unique($result,SORT_REGULAR));
var_dump(array_unique($result,SORT_NUMERIC));
?>
↓結果
array(6) {
  [0]=>
  int(4)
  [1]=>
  string(1) "4" # 型は違うが文字として比較すると[0]に一致→除外対象
  [2]=>
  string(1) "3"
  [3]=>
  int(4) # [0]に一致→除去対象
  [4]=>
  int(3) # 型は違うが文字として比較すると[2]に一致→除去対象
  [5]=>
  string(1) "3" # [2]に一致→除去対象
  [6]=>
  string(3) "3.0" # 数値としては[2]に一致、文字としては不一致→REGULAR,NUMERICは除去対象
}
# 元の型は保持されている
array(2) {
  [0]=>
  int(4)
  [2]=>
  string(1) "3"
}
      

複数階層の配列の場合、

<?php
$a = array('A'=>array('0036','0037','0036','0038'),
	   'B'=>array('0012','0013','0012','0014'));
print_r($a);
print_r(array_unique($a,SORT_STRING));
echo $a['A']."\n";
echo $a['B']."\n";
print_r(array_unique($a,SORT_REGULAR));
#- 下位階層の各値の重複を取り除くには各下位階層にarray_uniqueを適用
foreach ($a as $key=>$subarray) {
  $a[$key] = array_unique($subarray);
}
?>

#- 元の配列
Array
(
    [A] => Array
        (
            [0] => 0036
            [1] => 0037
            [2] => 0036
            [3] => 0038
        )

    [B] => Array
        (
            [0] => 0012
            [1] => 0013
            [2] => 0012
            [3] => 0014
        )
)
#- 文字列として比較して処理した結果（既定の動作もこれ）
Array
(
    [A] => Array
        (
            [0] => 0036
            [1] => 0037
            [2] => 0036
            [3] => 0038
        )
)
# どちらも"Array"という文字列として判断され一致するので、後者は除去される
a['A']: Array
a['B']: Array
# 型そのままだとそれぞれの配列内容は異なるので除去対象なし
Array
(
    [A] => Array
        (
            [0] => 0036
            [1] => 0037
            [2] => 0036
            [3] => 0038
        )

    [B] => Array
        (
            [0] => 0012
            [1] => 0013
            [2] => 0012
            [3] => 0014
        )
)
# 各下位階層内で重複除去するにはループ処理により可能
Array
(
    [A] => Array
        (
            [0] => 0036
            [1] => 0037
            [3] => 0038
        )

    [B] => Array
        (
            [0] => 0012
            [1] => 0013
            [3] => 0014
        )
)
      

配列を１つにマージ

array_mergeは指定した１つ以上の配列に含まれる全要素を１つの配列に格納して返す。 文字列をキーにもつ要素（連想配列要素）で同じキーを持つ要素が存在した場合、後に登場した値で上書きされる。数字をキーに持つ要素の場合、登場順に0からの通しの連番が振り直される。

【書式】
array_merge(配列,配列...);
配列 + 配列 + 配列...;

【例】
$array1 = array("color" => "red", 2, 4);
$array2 = array("a", "b", "color" => "green", "shape" => "trapezoid", 4);
$result_merge = array_merge($array1, $array2);
$result_add = $array1 + $array2;
echo '$array1:';
print_r($array1);
echo '$array2:';
print_r($array2);
echo '$result_merge:';
print_r($result_merge);
echo '$result_add:';
print_r($result_add);
【結果】
$array1:Array
(
    [color] => red
    [0] => 2
    [1] => 4
)
$array2:Array
(
    [0] => a
    [1] => b
    [color] => green
    [shape] => trapezoid
    [2] => 4
)
$result_merge:Array
(
    [color] => green ←後の配列（$array2）がセットされている
    [0] => 2
    [1] => 4
    [2] => a
    [3] => b
    [shape] => trapezoid
    [4] => 4
)
$result_add:Array
(
    [color] => red ←前の配列（$array1）がセットされている
    [0] => 2
    [1] => 4
    [shape] => trapezoid
    [2] => 4 ←後の配列（$array2）にしかないキー要素のみ追加
)

      

キー値が同一であっても両方とりこみたいなら、foreachを使って別の配列に各要素を格納していけばよい（但し、キーと値の関係は崩れる）。

【例】
$array1 = array("color" => "red", 2, 4);
$array2 = array("a", "b", "color" => "green", "shape" => "trapezoid", 4);
foreach ($array1 as $val) {
  $result[] = $val; ←キーを指定しない場合、最大数字キーの次の番号が自動で設定される
}
foreach ($array2 as $val) {
  $result[] = $val;
}
print_r($result);
【結果】
Array
(
    [0] => red
    [1] => 2
    [2] => 4
    [3] => a
    [4] => b
    [5] => green
    [6] => trapezoid
    [7] => 4
)
      

複数配列に共通する要素を得る

array_intersectは複数配列に共通する要素を返す。戻り値となる配列のキーは比較元配列のキーが維持される。

array_intersect(比較元配列,比較対象配列,比較対象配列)
      

変数が配列であるか調べる（is_array）

is_arrayは変数が配列であるかどうかを調べる。配列型の場合はtrue、それ以外はfalseを返す。

is_array(変数)
      

参考文献・サイト：

• PHP 基礎編8 - 配列操作、sort、asort、ksort、array_push、array_shift - SAK Streets
• PHP Manual:配列
• PHP Manual:PHP: 配列関数
• PHP Manual:print_r

条件分岐（if）

ifは処理の条件分岐を記述する。else、else ifを併用することにより複数の条件分岐を記述することができる。また入れ子構造にすることも可能。

条件分岐（switch）

switchは単一の変数の値によって処理を分岐させるのに用いることができる。なお、swtich、caseで行われる比較は緩やかな比較（データ型が一致しているかどうかまでは見ない）となる。

caseで指定する条件にマッチした場合、breakに出会うまでの内容が処理される。defaultはどのcaseにもマッチしなかった場合に適用される。

switch(変数名) {
  case 値1;
    式1;
    break;
  case 値2;
    式2;
    break;
  …
  case 値n;
    式n;
    break;
  default;
    式(n+1);
    break;
}

評価の対象となる変数を変数名で指定し、その後case節で条件を記述する。if...else if...文と異なるのは、breakを記さないと、switch文の最後まで処理されてしまう点。逆にそれを利用して複数の条件を束ねることができる（式1とその後のbreakを記さないと、値1または値2の場合に式2が処理される。

switch($obj) {
  case "Nara";
  case "Osaka";
  case "Kyoto";
  case "Hyogo";
  case "Shiga";
  case "Wakayama";
    echo "It's in the Kinki region.";
    break;
  case "Kagawa";
  case "Tokushima";
  case "Ehime";
  case "Kochi";
    echo "It's in the Shikoku region.";
    break;
  default;
    echo "It's neither in the Kinki region nor in the Shikoku region.";
    break;
}
      

概要

mailコマンドによってメールを送信することができる。なお、メールに関するマルチバイト関数をオーバーロードする設定を行っていると、mb_send_mail関数に読み替えて実行される。

【書式】
mail(宛先,件名,本文,追加ヘッダ,追加オプション)
mb_send_mail(宛先,件名,本文,追加ヘッダ,追加オプション)

【戻り値】
メール送信に成功→true
メール送信に失敗→false
      

宛先

RFC 2822を満たす書式で書かれたメールの送信先。電子メールアドレスをそのまま記すか、あるいは不等号（< ... >）で囲んでその前に別名を記す。複数のアドレスを併記する場合はコンマ（,）で区切る。

user@example.com
user@example.com, anotheruser@example.com
User <user@example.com>
User <user@example.com>, Another User <anotheruser@example.com>

なお、名前部分に日本語を使っている場合、mb_encode_mimeheaderを使ってmimeエンコード処理を行わないと受信されたメールの宛先名前部分が文字化けしてしまう。追加ヘッダ中のFrom, Cc, Bccについても同様。

【例】宛先をmimeエンコードする
<?php
$to  = mb_encode_mimeheader('くいだおれ太郎');
$to .= sprintf(' <%s>',taro@kuidaore.com);
...
mail($to,$subject,$body,$addheader);
?>

件名

RFC 2047を満たすメールの件名。

本文

メール本文。改行コードはLF（\n）で各行の長さは70文字以下にすること（参照：wordwrapコマンド）。 Windows環境の場合、ピリオドから始まる行は無視されるが、これを防ぐには、行頭のピリオドをピリオド 2 つに置換すればよい（例：$body = str_replace("\n.","\n..",$body);）。

追加ヘッダ

送信元（From）、カーボンコピー（Cc）、ブラインドカーボンコピー（Bcc）の挿入に用いる。複数のヘッダを追加する際はCRLF（\r\n）で区切る。Fromは必須だが、php.iniで既定値を指定していれば省略可能。

またここに記す文字列はmb_encode_mimeheaderを使って文字エンコーディング変換を行い、適正な言語設定を行わないと文字化けすることがある（mb_language、mb_internal_encoding参照）¹¹、¹⁶。

追加オプション

sendmailなどのメール配信エージェント（MTA）にコマンドラインオプションを渡す際に用いる。

【例】
<?php
$from = "white@yagisan.net"; ←送信者アドレス
$fromname = "しろやぎ"; ←送信者名
$to = "black@yagisan.net"; ←宛先アドレス
$toname = "くろやぎ"; ←宛先人名
$subject = "こんにちわ"; ←件名
$body = <<< DOC_END
こんにちは、お元気ですか。
またメールします。
DOC_END;

$addheader  = "From: " . mb_encode_mimeheader($fromname);
$addheader .= "<" . $from . ">\r\n";

mb_language("ja");
mb_internal_encoding("UTF-8");
mb_send_mail($to,$subject,$body,$addheader);
?>
      

なお、Unicodeメールを送るには以下の２行を追加ヘッダに記述する必要あり¹²。

Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 8bit

あるいはこう？²²

Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: BASE64

それと、メールエンベロープにもfromアドレスを設定した方がいいみたい（迷惑メールとみなされるのを抑制するため）。そのためにはmail(mb_send_mail)の第5引数に「-f [fromアドレス]」を指定しておく²²

メールアドレスの仕様

メールアドレス全体でASCII文字256文字以下。

ローカル部（@の前）

以下のASCII文字が使用可能。文字数は最大64文字（プロバイダやメールソフトの制約のため実際使えるのはこれより少ない場合がある）。

• 英字（本来は大文字小文字は区別されるが、実際は区別されない実装が大半）
• 数字
• ! # $ % & ' * + - / = ? ^ _ ` { | } ~（実際はこのうちの一部のみを許可するの制限を加えた実装が多い）
• .（ピリオド、先頭と末尾以外で使用可能。２個以上連続してはいけない。）

" "で囲んだquoted-stringの形式であれば以下のASCII文字も使用可能

• # ( ) < > [ ] : ; @ ,
• .（ピリオド、quoted-string内での制限はなし）
• 空白（スペース）

ドメイン部（@の後）

次のいずれかが使用可能。文字数は最大255文字。

• サブドメイン（ASCII文字のうち、英数字とハイフン（-）、但し先頭は英数字）をピリオド（.）でつないだもの（完全修飾ドメイン名、FQDN）
• "[ ]"でくくったIPアドレス

例

• mail.hoge-fuga.com
• [192.168.0.100]

メールアドレスチェック例

<?php
$addresses = "user1@mail.hoge-fuga.com, user2@mail.foofoo.net";
#- エラーコードとメッセージの定義
$errmsg = array(0 => 'メールアドレスに使えない文字が含まれています（使用できるのは半角英数字記号です）。',
                1 => 'メールアドレスの文字数が多すぎます。256文字以下にして下さい。',
                2 => '@がないか、または２個以上あります。@は１つのメールアドレスにつき１個にして下さい。',
                3 => '@の前（ローカル部）の文字が多すぎます。@の前は64文字以下にして下さい。',
                4 => '@の前（ローカル部）に使用できない文字が含まれています。使用できる文字は半角英数字と!#$%&'*+-/=?^_`{|}~.のいずれかです。',
                5 => '@の前（ローカル部）の先頭末尾にピリオドは使用できません。',
                6 => '@の前（ローカル部）に連続したピリオドは使用できません。',
                7 => '@の後（ドメイン部）の文字が多すぎます。@の後は255文字以下にして下さい。',
                8 => '@の後（ドメイン部）に使用できない文字が含まれています。使用できる文字は半角英数字とハイフン、ピリオド（-.）のいずれかです。',
                9 => '@の後（ドメイン部）の先頭に使用できる文字は半角英数字のみです（先頭にはハイフンやピリオドは使えません。）');
#- チェックフラグ初期値
$check = true;
#- 空白類（タブ、リターン、改行、NUL、垂直タブも含む）を除去
$addresses = preg_replace_all('/[ \t\n\r\0\x0B]/','',$address);
#- ASCII英数字記号以外があればチェックfalse
if (preg_match('/[^\x21-\x7e]/',$addresses) != false) {
  $check = false;
  $errcode = 0;
} else {
  #- メールアドレスをコンマで分割して配列に格納
  $address_array = implode(",",$addresses);
  #- 各メールアドレスをチェック
  foreach ($address_array as $address) {
    #- 文字数が256文字を越えていたらチェックfalse
    if (strlen($address) > 256) {
     $check = false;
     $errcode = 1;
    #- @が１個でなかったらチェックfalse
    } else if (preg_match_all('/@/',$address) !== 1) {
     $check = false;
     $errcode = 2;
    } else {
      $local = substr($address,0,strpos($address,'@'));
      #- ローカル部が64文字を越えていたらチェックfalse
      if (strlen($local) > 64) {
        $check = false;
        $errcode = 3;
      #- ローカル部に許容される文字以外があればチェックfalse
      } else if (preg_match("/[^0-9A-Za-z!#$%&'*+\-/=?^_`{|}~.]/",$local) != false) {
        $check = false;
        $errcode = 4;
      #- ローカル部先頭末尾にピリオドがあればチェックfalse
      } else if (preg_match('/(^\.|\.$)/',$local) != false) {
        $check = false;
        $errcode = 5;
      #- ローカル部に連続するピリオドがあればチェックfalse
      } else if (preg_match('/\.\./',$local) != false) {
        $check = false;
        $errcode = 6;
      }
      $domain = substr($address,(strpos($address,'@')+1));
      #- ドメイン部が255文字を越えていたらチェックfalse
      if (strlen($local) > 255) {
        $check = false;
        $errcode = 7;
      #- ドメイン部に許容される文字以外があればチェックfalse
      } else if (preg_match('/^[^0-9A-Za-z\-.]/',$local) != false) {
        $check = false;
        $errcode = 8;
      #- ドメイン部の先頭が英数字でなればチェックfalse
      } else if (preg_match('/^[0-9A-Za-z]/',$local) == false) {
        $check = false;
        $errcode = 9;
      }
    }
  }
  if ($check === false) {
    echo "Error was found!\n" . $errmsg[$errcode] . "\n";
  } else {
    echo "Address checking OK!\n";
  }
}
?>
      

メールアドレス確認の仕組みを加えたメールシステム

メールフォームでsubmit→送られてきたメールに記載されたURLをクリック→送信実行、というメールアドレスが有効なものであるかを確認してから送信するメールシステムの作り方について。参考サイト2で紹介されている会員登録システムとは異なり、1回限り有効であればよいものを作る。

1. 確認コードを保存するMySQLテーブルを作る

カラム名	データ型	内容
confirm_code	varchar(64)	確認コード
received_date	date	送信リクエスト受信日時
from_name	varchar(192)	送信者名（64文字以内）
from_address	varchar(256)	送信者メールアドレス（256文字以内）
subject	varchar(192)	件名（64文字以内）
body	text	本文

mysql> CREATE TABLE mail_queue (confirm_code VARCHAR(32),received_date DATE,from_name VARCHAR(192),from_address VARCHAR(256),subject VARCHAR(192),body TEXT);
	  

2. メールフォームからsubmitされると確認メールを送信

3. 確認メールのURLにアクセスすると本来の内容が送信される

参考文献・サイト

1. PHP: mail - Manual
2. Verifying email address…PHPeasystep.comより

ファイルを開く

fopenは指定したファイルを開いてアクセス可能な状態にする。戻り値はファイルアクセスの際に指定するファイルポインタ（ファイルポインタリソース、オープンに失敗した場合は false）。gzopenの場合はgzip圧縮ファイルでも扱える（圧縮解凍操作を意識しなくてもアクセスできる）。

【書式】
fopen(ファイル名,アクセスモード)

gzopen(ファイル名,アクセスモード)
【戻り値】
正常にオープン→ファイルポインタリソース
not→false

引数

ファイル名（データ型：文字列）

"スキーム://..." の形式である場合はURLとみなし、そのプロトコルのハンドラ（ラッパー）を探す。そのプロトコルに対するラッパーが登録されていなければスクリプトに潜在的な問題があることを示す NOTICE を発行したうえで、ファイル名を通常のローカルファイルとみなして開くことを試みる。

ファイルがローカルファイルを示していると判断されると、そのファイルへのストリームを開く。

ファイル名が登録されているプロトコルを示していると判断され、かつそのプロトコルがネットワーク URL として登録されていれば、 PHP は allow_url_fopen が有効となっているかどうかチェックする。 もしこれがオフになっていると、PHP は warning を発行し fopen は失敗する。

アクセスモード（データ型：文字列）

指定可能な値は以下の通り。

モード	読み	書き	ファイルポインタ	ファイル既存	ファイル未存	備考
'r'	○	×	先頭	○	エラー
'r+'	○	○	先頭	○	エラー
'w'	×	○	先頭	消去	新規作成
'w+'	○	○	先頭	消去	新規作成
'a'	×	○	末尾	追記	新規作成
'a+'	○	○	末尾	追記	新規作成
'x'	×	○	先頭	エラー	○
'x+'	○	○	先頭	エラー	○

戻り値

ファイルオープン成功→ファイルポインタリソース（リソース (resource) 型）fgets/gzgetsによるファイル内容の取得などで用いる。

ファイルオープン失敗→false（論理 (boolean) 型）

↑上位メニュー（ファイルシステム関係）に戻る

ファイル閉じる

fcloseはファイルを閉じる。fopenでファイルを開いた時に戻り値として得られるファイルポインタを引数に指定。gzopenで開いた場合はgzcloseで閉じる。

【書式】
fclose(ファイルポインタ)
gzclose(ファイルポインタ)

標準出力から読み込むにはファイルポインタとしてSTDINを指定する。これはファイルオープン・クローズのの手続きを踏む必要はない（fopen、fcloseの手続きを踏まなくてもfgetsで1行取得可能）^[2]。

↑上位メニュー（ファイルシステム関係）に戻る

ファイル終端検出（feof）

feofはファイルポインタがファイルの終端に達しているかを返す。終端、エラーの場合true、その他の場合はfalseを返す。gzeofはgzopenで開いたファイルを扱う以外は同じ。

【書式】
feof(ファイルポインタ)
gzeof(gzファイルポインタ)
【戻り値】
ファイルポインタがEOFではない位置を指す→false
ファイルポインタが EOF に達している→true
エラー発生（ソケットタイムアウトを含む）→true
      

ファイルポインタにはfopenなどで開いたファイルのポインタを指定する。無効なファイルポインタ（無効なファイルを開こうとすると、fopenはfalseを返す）を渡すと、いつまでもEOFに達せず（feofの戻り値がtrueにならず）無限ループに陥ることがあるので注意。 ファイルポインタがfalseでない場合のみファイル読み込みを行うようなエラー回避の条件分岐を設ける方が安全。

↑上位メニュー（ファイルシステム関係）に戻る

ディレクトリの開閉

opendirはディレクトリを開く。戻り値は処理に成功するとファイル名取得アクセスの際指定するディレクトリハンドル、失敗するとfalse。

closedirはディレクトリを閉じる。引数にはopendirで開いた時の戻り値として得られるディレクトリハンドル。

【書式】
opendir(パス)
closedir(ディレクトリハンドル)
      

ディレクトリ内のファイル等の情報を得る

readdirは、opendirで開いたディレクトリ内のアイテム（ファイルやディレクトリなど）の情報を１つ読む。成功すればファイル名を、失敗すればfalseを返す。戻り値にはfalseとして評価される0や""が来る可能性があるため、失敗（＝これ以上読むべきものがないなど）を検知するには型まで識別する"==="演算子や"!=="演算子を用いること。

【書式】
readdir(ディレクトリハンドル)

【例】ユーザホームディレクトリの一覧を標準出力へ出力
if ($dir_handle = opendir("~")) { # 代入した結果を条件にしている（代入なので等号は一つ）
  while (($file = readdir($dir_handle)) !== false) {
    echo $file . "\n";
  }
}

【例】ユーザホームディレクトリの一覧を標準出力へ出力（. と .. を除く）
if ($dir_handle = opendir("~")) {
  while (($file = readdir($dir_handle)) !== false) {
    if (($file != ".") and ($file != "..")) {
      echo $file . "\n";
    }
  }
}
      

ファイル存在判定（file_exists）

file_existsはファイルまたはディレクトリが存在するかを調べる。ファイルが存在すればtrue、存在しなければfalseを返す。

【書式】
file_exists(ファイル名)
      

ファイル名

ファイルあるいはディレクトリへのパス。

ファイル属性判定（is_file、is_dir、id_link）

ファイル等の属性を判定する関数を以下に示す。

【書式】
is_file(文字列)
is_dir(文字列)
is_link(文字列)
【戻り値】文字列に指定したファイル等が
is_file：通常ファイル→true、それ以外→false
is_dir：ディレクトリ→true、それ以外→false
is_link：シンボリックリンク→true、それ以外→false

ディレクトリ作成（mkdir）

mkdirはディレクトリを作成する。ディレクトリ作成に成功すれば true、失敗すれば false を返す。ディレクトリを削除するのはrmdir。

【書式】
mkdir(パス名,モード,recursive,コンテキスト);

【戻り値】データ型：論理値（boolean）
処理に成功→true
処理に失敗→false

パス名

ディレクトリのパス

モード

アクセス権のモードを8進数で指定する。先頭に0を付けて8進数であることを明示する必要がある。既定値は0777（全てのユーザが読み書き実行可能）。Windowsではこの設定は無視される。

recursive

パス名で指定したディレクトリの上位ディレクトリが存在しない場合に合わせて作成するかどうかを指定する。trueを指定すれば上位ディレクトリも合わせて作成し、falseを指定すれば作成しない。既定値はfalse。

ファイルサイズ取得（filesize）

filesizeは指定ファイルのファイルサイズ（単位はバイト）を返す。エラーの場合は false を返すか、または E_WARNING レベルのエラーを発生させる。

【書式】
filesize(ファイル名)

引数

ファイル名

[文字列] ファイルへのパス

戻り値

【例】
$ php -r 'echo filesize("test.txt")."\n";'
1234

１行取得（fgets, gzgets, fgetcsv）

fgetsはfopenで開いたファイルのポインタ位置から１行分を取得して返す。戻り値には末尾の改行文字も含む。gzgetsはgzopenで開いたファイルを扱うこと以外は同等。

【書式】
fgets(ファイルポインタ,読み込み長);
gzgets(ファイルポインタ,読み込み長);
【戻り値】
ファイルポインタがファイルの末端ではない→ファイルポインタで指定したファイルポインタから最大読み込み長-1 バイトを読み出して得られた文字列（gzgetsの場合は解凍後の文字列）
ファイルポインタがファイルの末端→false
エラー→false

ファイルポインタにはfopenやfsockopenで正常にオープンされ、まだcloseされていないファイルポインタを指定する（gzgetsの場合はgzopen）。読み込み長を指定した場合、指定値-1バイトを読み出すか、または改行、ファイルの終端（EOF）を検出した時点で読み込みを終了する。指定がない場合は改行またはファイルの終端を検出するまで読み続ける。戻り値は正常に内容を取得できればその読み込んだ文字列、エラーがあればfalse。

【例１】単にファイルを読んで１行ずつ出力
<?php
$handle = fopen('hoge.txt','r');
#-- ファイルopenに成功した場合
if ($handle) {
  while (!feof($handle)) {
    echo fgets($handle);
  }
#-- ファイルopenに失敗した場合
} else {
  echo "hoge.txt は開けませんでした。\n";
}
?>
※上記の内容なら、freadを使うなどした方が簡単

【例２】ファイルの各行を読み込んで 「行頭が#」または「#の前に空白文字しかない」行を除いて出力
<?php
$handle = fopen('hoge.txt','r');
#-- ファイルopenに成功した場合
if ($handle) {
  #-- 最初の1行を読み込み（$lineの初期値定義も兼ねて）
  $line = fgets($handle);
  #-- ファイルの最終行まで処理を繰り返し
  #-- 行コンテンツチェックも入れないと、最後の1行が処理されずループが終わる
  while ((!feof($handle)) or ($line !== false)) {
    #-- 「行頭が#」または「#の前に空白文字しかない」行を除いて出力
    if (preg_match('/^\s*#/',$line) == false) {
      echo $line;
    }
    #-- 次の1行を読み込み
    $line = fgets($handle);
  }
#-- ファイルopenに失敗した場合
} else {
  echo "hoge.txt は開けませんでした。\n";
}
?>

標準入力から1行ずつ読み込む例：

$ cat test.php
<?php
while (($line = fgets(STDIN)) !== false) {
  echo 'あなたは「'.trim($line)."」と入力しましたね\n";
}
?>
$ php test.php -
hoge
あなたは「hoge」と入力しましたね
foo
あなたは「foo」と入力しましたね
(Ctrl-D)
$ 

csvファイルを1行読み込む際はfgetcsvを使うと便利

ただし、この関数はロケール設定を考慮するため、設定とは異なる文字コードで書かれたCSVファイルを読み込むと値が文字化けする可能性がある。これに対処する方法として、ストリームフィルタをつくる方法がある²¹。あるいはmb_convert_encodingコマンドを使って読み込んだ文字列を変換する、あらかじめエディタで文字コードを変換したファイルを入力ファイルとして用いる、という方法が考えられる。

【書式】
fgetcsv(ファイルポインタ,読み込み長,フィールド分割文字,フィールド囲み文字,エスケープ文字);
【戻り値】
指定されたファイルポインタが有効でファイルポインタがファイルの末端ではない→読み込んだフィールドの内容を含む数値添字配列
※空行であった場合、nullフィールドを1つだけ含む配列を返す
ファイルポインタがファイルの終端、その他エラー→false
指定されたファイルポインタが無効→null