PHPの関数について

1. 組み込み関数（ビルトイン関数）

PHPがあらかじめ用意している関数です。
例：strlen()（文字列の長さを取得する）、array_push()（配列に要素を追加する）など。

特徴

• PHPの標準機能としてすぐに使える
• 数百〜数千の関数が用意されている
• 高速で安定している

2. ユーザー定義関数

開発者が自分で作成する関数です。
コードの再利用や処理のまとめに使います。

書き方の例

function greet($name) {
  return "こんにちは、" . $name . "さん！";
}
echo greet("太郎"); // こんにちは、太郎さん！

特徴

• 任意の処理をまとめられる
• 引数や戻り値を自由に設定可能
• 大規模なコードで可読性や保守性を向上させる

3. 匿名関数（無名関数）

名前を持たずに、その場で定義して変数に代入したり、コールバック関数として使う関数です。

書き方の例

$sayHello = function($name) {
  return "Hello, " . $name;
};
echo $sayHello("Alice"); // Hello, Alice

特徴

• 名前を持たないため、その場限りの処理やコールバックに便利
• クロージャ（closure）として変数のスコープを取り込むことが可能
• コードがシンプルで柔軟に使える

3種類の関数まとめ

date()

日付や時間を取得・整形します。

echo date("Y-m-d"); // 例: 2025-06-25

strlen()

文字列の長さを調べます。

echo strlen("Hello"); // 5

strpos($a, $b)

文字列内で特定の文字や文字列が最初に現れる位置を調べます。見つからない場合はfalseを返します。

$pos = strpos("abcdef", "cd");
if ($pos !== false) {
    echo "位置は $pos";  // 2 と表示（0から数える）
} else {
    echo "見つかりません";
}

array_push($arr, $a)

配列の末尾に要素を追加します。

$arr = [1, 2];
array_push($arr, 3);
print_r($arr); // [1, 2, 3]

array_merge($arr1, $arr2)

2つの配列を結合して新しい配列を作ります。

$a = [1, 2];
$b = [3, 4];
$c = array_merge($a, $b);
print_r($c);  // [1, 2, 3, 4]

file_get_contents($filename)

ファイルの中身を文字列として読み込みます。

$content = file_get_contents("sample.txt");
echo $content;

これらの関数はドキュメント（公式マニュアル）を参照して使い方を覚えるとよいでしょう。

1. returnは関数の処理を終わらせる合図

return は「この値を返して関数を終わりますよ」という命令です。
return の後に書かれた値が、関数の呼び出し元に返されます。

また、return が実行されると、その関数の処理はそこで終了します。
つまり、return の後に書かれたコードは実行されません。

function checkNumber($n) {
    if ($n < 0) {
        return "負の数";  // ここで処理終了、文字列を返す
    }
    return "0以上の数";   // $nが0以上ならこちらが返される
    // この行の後のコードは実行されません
}

echo checkNumber(-1);  // 「負の数」と表示される
echo checkNumber(5);   // 「0以上の数」と表示される

2. 戻り値は変数に代入して使える

戻り値はそのまま画面に表示するだけでなく、変数に代入して他の処理に使うこともできます。

function add($a, $b) {
    return $a + $b;  // 足し算の結果を返す
}

$result = add(3, 7);  // 戻り値を$resultに代入
echo $result;         // 10 と表示される

3. 戻り値の型を決めることもできる（PHP7以降）

PHP7からは、関数が返す値の「型」をあらかじめ決められます。
例えば、「必ず整数を返す」関数は次のように書きます。

function addInt(int $a, int $b): int {
    return $a + $b;  // 結果は整数（int）として返す
}

このように型を指定すると、誤って違う型の値を返してしまうミスを防げます。

4. 戻り値を返さない関数はvoid型を使う（PHP7.1以降）

値を返さない関数は「戻り値がない」ことを明示的に示すために、void型を指定することができます。

function sayHi(): void {
    echo "Hi!";  // 画面に挨拶を表示するだけで、戻り値は返さない
}

void関数は、returnを使って値を返してはいけません。
（return;だけなら使えますが、値を返すのは禁止です）

1. ローカル変数は関数の中だけで使える

関数の中で作った変数は「ローカル変数」と呼ばれます。
この変数は、その関数の中だけで使えて、関数が終わると消えてしまいます。

function myFunction() {
    $localVar = "これはローカル変数";
    echo $localVar;  // ここでは使える
}

myFunction();
// echo $localVar;  // ここはエラーになる（関数の外だから使えない）

つまり、関数の外からはローカル変数を見ることも変更することもできません。

2. グローバル変数はプログラム全体で使える

関数の外で作った変数は「グローバル変数」と呼ばれ、通常はプログラムのどこからでも使えます。

ただし、関数の中から直接グローバル変数を使うことはできません。
関数の中でグローバル変数を使いたい場合は、特別な方法を使います。

3. 関数内でグローバル変数を使うにはglobalキーワードを使う

関数の中で、外のグローバル変数を使うときは、globalキーワードで「これはグローバル変数だよ」と伝えます。

$globalVar = "グローバル変数";

function useGlobal() {
    global $globalVar;  // これで関数内でも$globalVarが使える
    echo $globalVar;
}

useGlobal();  // 「グローバル変数」と表示される

globalを使わないと、関数の中は別の「ローカルな世界」になり、グローバル変数は見えません。

4. もう一つの方法：$GLOBALS 配列を使う

PHPには$GLOBALSという特別な配列があり、ここにすべてのグローバル変数が入っています。
関数の中でもこの配列を使えばグローバル変数にアクセスできます。

$var = "テスト";

function test() {
    echo $GLOBALS['var'];  // ここでグローバル変数$varを使う
}

test();  // 「テスト」と表示される

$GLOBALS配列はキーに変数名の文字列を指定してアクセスします。