PHPの関数の使い方を解説

2025-02-19更新日: 2025-02-19

PHPの関数は、コードの再利用や整理に役立つ便利な仕組みです。

この記事では、関数の定義方法や呼び出し方、具体的な利用例について解説します。

基本を押さえることで、プログラム作成の効率向上に繋がるポイントを分かりやすく紹介しています。

目次から探す

PHP関数の基礎
- 関数の定義と基本構文
- 組み込み関数とユーザー定義関数
PHP関数の活用例
- ファイル操作における関数利用
- 配列と文字列処理での関数利用
高度な関数利用方法
- 再帰関数の実装方法
- 無名関数とクロージャ
まとめ

PHP関数の基礎

関数の定義と基本構文

関数宣言の記述方法

PHPでは、関数を定義する際にキーワード「function」を用います。

関数名、引数リスト、そして処理内容をブロック(中括弧)内に記述します。

以下は、2つの数値を加算するシンプルな関数の例です。

<?php
// 2つの数値を加算する関数を定義
function addNumbers($a, $b) {
    // 引数$aと$bの和を返す
    return $a + $b;
}
// 関数の呼び出し例
$result = addNumbers(5, 3);
echo $result; // 結果を出力
?>

引数と返り値の扱い方

関数には、必要な情報を渡すための引数を設定することができます。

引数は関数呼び出し時に値を渡すことで利用され、関数内で演算や処理に用いられた後、結果を返り値として返すことがあります。

以下の例は、引数として受け取った値を変数に代入し、その結果を返す関数の例です。

<?php
// 2つの値の和を計算して返す関数
function sumValues($value1, $value2) {
    // 演算結果を変数$resultに代入
    $result = $value1 + $value2;
    return $result;
}
// 関数の利用例
$total = sumValues(10, 15);
echo $total; // 結果を出力
?>

組み込み関数とユーザー定義関数

組み込み関数の使用例

PHPには、多くの役立つ組み込み関数が用意されており、文字列操作や配列処理、ファイル操作など様々な用途に活用できます。

以下の例は、文字列の長さを取得する組み込み関数strlenの使用例です。

<?php
$str = "PHP関数";
$length = strlen($str); // 文字列の長さを取得
echo $length; // 結果を出力
?>

ユーザー定義関数の作成方法

ユーザー定義関数は、開発者が必要な処理をまとめた独自の関数を作成するために使用されます。

以下は、与えられた文字列を大文字に変換して返す関数の例です。

<?php
// 文字列を大文字に変換する関数を定義
function convertToUpper($text) {
    return strtoupper($text);
}
// 関数の呼び出し例
$resultText = convertToUpper("php関数");
echo $resultText; // 結果を出力
?>

PHP関数

PHP関数の活用例

ファイル操作における関数利用

ファイル読み込み関数の使用例

PHPでは、ファイルの内容を読み取るためにfile_get_contents関数がよく使用されます。

以下の例では、テキストファイル「sample.txt」から内容を取得し、出力しています。

<?php
// sample.txt には "Hello, PHP!" という内容が保存されていると仮定
$content = file_get_contents("sample.txt");
echo $content; // ファイルの内容を出力
?>

Hello, PHP!

ファイル書き込み関数の使用例

ファイルにデータを書き込む際は、file_put_contents関数が利用されます。

以下の例は、文字列をファイル「output.txt」に書き込み、その後メッセージを出力する方法です。

<?php
$data = "PHP関数の書き込みサンプル";
// 指定したファイルにデータを書き込む
file_put_contents("output.txt", $data);
echo "ファイルに書き込みました";
?>

ファイルに書き込みました

配列と文字列処理での関数利用

配列操作関数の使用例

配列操作においては、array_mergeやarray_pushなどの関数がよく利用されます。

以下は、2つの配列を統合する例です。

<?php
$array1 = [1, 2, 3];
$array2 = [4, 5, 6];
// 2つの配列を連結する
$mergedArray = array_merge($array1, $array2);
print_r($mergedArray); // 結果を出力
?>

Array
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
    [4] => 5
    [5] => 6
)

文字列操作関数の使用例

文字列を操作する場合、str_replaceやsubstrなどの関数が役立ちます。

下記の例は、文字列中の一部の文字を他の文字列に置き換える例です。

<?php
$str = "PHP関数の解説";
// "解説"を"例"に置き換える
$modifiedStr = str_replace("解説", "例", $str);
echo $modifiedStr; // 結果を出力
?>

PHP関数の例

高度な関数利用方法

再帰関数の実装方法

再帰的なコードの記述方法

再帰関数は、関数自身を呼び出すことで問題を解決します。

階乗を計算する例を見てみましょう。

ここでは、 $n!$ を求めるための再帰関数を定義しています。

<?php
// 階乗を計算する再帰関数
function factorial($n) {
    if ($n <= 1) {
        return 1; // 基底条件
    }
    return $n * factorial($n - 1);
}
// 5の階乗を計算 (5! = 120)
$result = factorial(5);
echo $result; // 結果を出力
?>

利用時の注意点

再帰関数は深い再帰呼び出しによってスタックオーバーフローを引き起こす可能性があるため、再帰の深さには注意が必要です。

以下の例では、負の数に対する対処も加え、安心して利用できるようにしています。

<?php
// 安全な階乗計算のための再帰関数
function safeFactorial($n) {
    if ($n < 0) {
        return "エラー: 負の数は計算できません";
    }
    if ($n <= 1) {
        return 1;
    }
    return $n * safeFactorial($n - 1);
}
// 5の階乗を計算 (5! = 120)
echo safeFactorial(5); // 結果を出力
?>

無名関数とクロージャ

無名関数の定義方法

無名関数は、関数名を定義せずに関数を生成できる仕組みです。

変数に格納することで後から利用できるようにします。

下記の例は、名前を受け取りあいさつ文を返す無名関数の例です。

<?php
// 無名関数を変数に代入
$greet = function($name) {
    // 引数$nameを元にあいさつ文を生成
    return "こんにちは, " . $name . "さん";
};
// 無名関数の呼び出し例
echo $greet("太郎");
?>

こんにちは, 太郎さん

クロージャの利用例

クロージャは、無名関数が定義されるときに、そのスコープ外にある変数を取り込む仕組みです。

以下の例は、外部変数をクロージャ内で利用するケースです。

<?php
$message = "PHPのクロージャ";
// 無名関数内で外部変数$messageを利用するためにuseを利用
$printMessage = function() use ($message) {
    return "メッセージ: " . $message;
};
// クロージャの呼び出し例
echo $printMessage();
?>