PHP 関数の書き方｜引数・デフォルト値・型宣言・戻り値を一覧で解説

PHP の関数は、function 名前(型 $引数 = デフォルト値): 戻り値の型 { return 値; } の形で書きます。 引数の型・デフォルト値・戻り値の型はどれも省略できますが、PHP 8.x では型を書いておくと、渡し間違いをその場でエラーとして知らせてくれるので、読みやすく直しやすいコードになります。

この記事では、関数の定義から、型宣言、戻り値型（void・never・nullable・union）、デフォルト値、可変長引数、参照渡し、名前付き引数、無名関数・アロー関数・第一級 callable 構文までを、PHP 8.4.21 で実際に動かした結果とエラー文つきで順に解説します。冒頭に書き方の早見表と対応バージョン表を置いたので、必要な書き方をすぐにコピーできます。

PHP 関数の書き方 早見表

書き方の一覧

対応バージョン表

検証した環境と読み方

この記事のコードは、そのままファイルに保存して php ファイル名.php で実行できる形にしています。実行結果は、すべて上の環境で実際に出力されたものです。バージョンごとの対応表は、PHP マニュアルの「型宣言」と「関数の引数」のページを今回開いて確認した内容で、PHP 8.4 より前のバージョンでの動作そのものは実行していません。

関数の基本の書き方

<?php
function greet(string $name, string $greeting = 'こんにちは'): string
{
    return "{$greeting}、{$name}さん";
}

echo greet('佐藤'), PHP_EOL;
echo greet('鈴木', 'おはよう'), PHP_EOL;
echo greet(greeting: 'こんばんは', name: '田中'), PHP_EOL;

こんにちは、佐藤さん
おはよう、鈴木さん
こんばんは、田中さん

1つの関数には1つの役割だけを持たせ、名前は「動詞＋対象」にすると、呼び出し側が読みやすくなります。

知っておくと役立つ基本の性質

次の性質をまとめて確認しました。

<?php
// return を書かない関数は NULL を返す
function noRet() {}
var_dump(noRet());

// 関数の中から、外の変数は見えない
$site = 'memo';
function showSite() { return isset($site) ? 'あり' : 'なし'; }
echo showSite(), PHP_EOL;

// 定義より前の行からでも呼べる
echo later(), PHP_EOL;
function later(): string { return '後ろで定義しても呼べる'; }

// 関数名は大文字と小文字を区別しない
echo LATER(), PHP_EOL;

// static 変数は呼び出しをまたいで値を保つ
function nextId(): int { static $id = 0; return ++$id; }
echo nextId(), nextId(), nextId(), PHP_EOL;

// 再帰（自分自身を呼ぶ）
function fact(int $n): int { return $n <= 1 ? 1 : $n * fact($n - 1); }
echo fact(5), PHP_EOL;

NULL
なし
後ろで定義しても呼べる
後ろで定義しても呼べる
123
120

同じ名前の関数を2回定義すると、次の表示で止まりました。

Fatal error: Cannot redeclare function dup() (previously declared in 12_dup.php:2) in 12_dup.php on line 3

引数と戻り値に型を付ける（型宣言）

<?php
function subtotal(int $price, int $count = 1): int
{
    return $price * $count;
}
function findName(array $members, int $id): ?string
{
    return $members[$id] ?? null;
}
function toLabel(int|string $code): string
{
    return 'CODE-' . $code;
}
function logLine(string $message): void
{
    echo '[log] ', $message, PHP_EOL;
}
function stop(string $reason): never
{
    throw new RuntimeException($reason);
}

var_dump(subtotal(1200, 3));
var_dump(subtotal(1200));
var_dump(findName([1 => '佐藤'], 1));
var_dump(findName([1 => '佐藤'], 2));
var_dump(toLabel(7));
var_dump(toLabel('A7'));
var_dump(logLine('保存しました'));
try {
    stop('在庫がありません');
} catch (RuntimeException $e) {
    echo get_class($e), ': ', $e->getMessage(), PHP_EOL;
}

int(3600)
int(1200)
string(6) "佐藤"
NULL
string(6) "CODE-7"
string(7) "CODE-A7"
[log] 保存しました
NULL
RuntimeException: 在庫がありません

使える型の一覧

戻り値型 void・never・nullable・union の違い

void は「返す値がない」、never は「そもそも戻ってこない」という違いです。 void の関数を var_dump すると NULL が表示されますが、never の関数は例外を投げるか処理を終えるので、呼び出しの次の行には進みません。

union 型で「見つからないときは false」を表す例と、mixed の例も確認しました。

<?php
function ratio(int|float $a, int|float $b): float { return $a / $b; }
var_dump(ratio(1, 4));

function find(int $id): string|false { return $id === 1 ? '佐藤' : false; }
var_dump(find(2));

function typeName(mixed $v): string { return get_debug_type($v); }
echo typeName(1), ' ', typeName('a'), ' ', typeName(null), ' ', typeName([1]), ' ', typeName(1.5), PHP_EOL;

float(0.25)
bool(false)
int string null array float

なお、?int|string のように ? と union を組み合わせる書き方はできません。実行すると構文エラーになりました。null を含めたいときは int|string|null と書きます。

Parse error: syntax error, unexpected token "|", expecting variable in 16_nu.php on line 2

strict_typesの有無で結果が変わる例

PHP の型宣言には2つのモードがあります。既定のモード（型の自動変換あり）では、渡された値を宣言した型に変換できるなら変換して受け取ります。 ファイルの先頭に declare(strict_types=1); を書くと、変換をせず、型が合わなければ TypeError になります。

同じ関数に同じ値を渡して、両方のモードで比べました。

<?php
// declare(strict_types=1);   ← この行の有無だけを変えて2回実行
function subtotal(int $price, int $count): int
{
    return $price * $count;
}
function half(float $n): float { return $n / 2; }
function count2(): int { return '3'; }

// 以下を1つずつ try〜catch (TypeError $e) で囲んで実行
subtotal('1200', 3);
subtotal(1200.0, 3);
subtotal(true, 3);
subtotal(1200.5, 3);
subtotal('12a', 3);
subtotal(null, 3);
half(5);
count2();

実際に表示されたメッセージは次のとおりです。

（strict_types なしで subtotal(1200.5, 3) を実行）
Deprecated: Implicit conversion from float 1200.5 to int loses precision in 03_weak.php on line 2
int(3600)

（strict_types=1 で subtotal('1200', 3) を実行）
TypeError: subtotal(): Argument #1 ($price) must be of type int, string given, called in 04_strict.php on line 7

（strict_types=1 で count2() を実行）
TypeError: count2(): Return value must be of type int, string returned

この結果から読み取れる要点は4つです。

• 既定のモードでは '1200' や true が黙って int に変換される。 画面のフォームから届く値は文字列なので便利な反面、意図しない値が通ることもある
• 小数部分のある float を int に渡すと、既定のモードでは非推奨の通知とともに切り捨てられる（1200.5 が 1200 として計算された）
• strict_types=1 では、型が一致しない値はすべて TypeError になる。 例外は「float の引数に int を渡す」場合だけで、これは両方のモードで通る
• '12a' や null は、どちらのモードでも TypeError になる（nullable ではない型に null は渡せない）

PHP マニュアルの「型宣言」のページによると、strict_types はその宣言を書いたファイルの中からの関数呼び出しに効きます。関数を定義したファイルではなく、呼び出す側のファイルの宣言で決まる点が要点です。新しく書くファイルでは先頭に declare(strict_types=1); を置き、外から届いた文字列は (int) や filter_var() で明示的に変換してから渡す、という進め方がおすすめです。

デフォルト値の書き方と、置く順番

デフォルト値は $引数 = 値 の形で書き、呼び出し側が省略したときに使われます。

<?php
function createUser(string $name, int $age = 20, bool $admin = false, string $lang = 'ja'): string
{
    return sprintf('%s / %d / %s / %s', $name, $age, $admin ? 'admin' : 'user', $lang);
}
echo createUser('佐藤'), PHP_EOL;   // 佐藤 / 20 / user / ja

new をデフォルト値に書く例も動かしました。

<?php
function stamp(DateTimeImmutable $at = new DateTimeImmutable('2026-10-03')): string
{
    return $at->format('Y-m-d');
}
echo stamp(), PHP_EOL;   // 2026-10-03

任意引数の後に必須引数を置くと、非推奨の警告が出る

デフォルト値のある引数（任意引数）は、必須引数の後ろに並べます。 逆の順番にするとどうなるかを確認しました。

<?php
function makeLabel($prefix = 'ID', $number)
{
    return $prefix . '-' . $number;
}
echo makeLabel('NO', 5), PHP_EOL;
try {
    echo makeLabel(number: 5), PHP_EOL;
} catch (Error $e) {
    echo get_class($e), ': ', $e->getMessage(), PHP_EOL;
}

Deprecated: makeLabel(): Optional parameter $prefix declared before required parameter $number is implicitly treated as a required parameter in 06_deprecated.php on line 2
NO-5
ArgumentCountError: makeLabel(): Argument #1 ($prefix) not passed

非推奨（Deprecated）の通知が出て、$prefix のデフォルト値は使われず、必須引数として扱われます。 名前付き引数で number だけを渡しても、$prefix が渡されていないという ArgumentCountError になりました。

型 $x = null は ?型 と書く

PHP 8.4 では、nullable ではない型に = null を付ける書き方にも通知が出ました。

<?php
function setOwner(string $owner = null) { return var_export($owner, true); }
echo setOwner(), PHP_EOL;

Deprecated: setOwner(): Implicitly marking parameter $owner as nullable is deprecated, the explicit nullable type must be used instead in 06_deprecated.php on line 9
NULL

TypeErrorとArgumentCountErrorを再現する

引数の数や型が合わないときに出るエラーを、まとめて再現しました。

<?php
function subtotal(int $price, int $count): int
{
    return $price * $count;
}
try { subtotal(1200); }      catch (ArgumentCountError $e) { echo get_class($e), ': ', $e->getMessage(), PHP_EOL; }
try { subtotal('abc', 2); }  catch (TypeError $e)          { echo get_class($e), ': ', $e->getMessage(), PHP_EOL; }
var_dump(subtotal(1200, 2, 99));
try { strlen(); }            catch (ArgumentCountError $e) { echo get_class($e), ': ', $e->getMessage(), PHP_EOL; }
try { strlen('a', 'b'); }    catch (ArgumentCountError $e) { echo get_class($e), ': ', $e->getMessage(), PHP_EOL; }
var_dump($e instanceof TypeError);

ArgumentCountError: Too few arguments to function subtotal(), 1 passed in 05_errors.php on line 6 and exactly 2 expected
TypeError: subtotal(): Argument #1 ($price) must be of type int, string given, called in 05_errors.php on line 7
int(2400)
ArgumentCountError: strlen() expects exactly 1 argument, 0 given
ArgumentCountError: strlen() expects exactly 1 argument, 2 given
bool(true)

最後の bool(true) が示すとおり、ArgumentCountError は TypeError の一種です。 catch (TypeError $e) と書けば両方をまとめて受け取れます。

try〜catch で受け取らない場合は、Fatal error として次のように表示されます。

Fatal error: Uncaught TypeError: subtotal(): Argument #1 ($price) must be of type int, string given, called in 05_errors.php on line 18 and defined in 05_errors.php:2
Stack trace:
#0 05_errors.php(18): subtotal()
#1 {main}
  thrown in 05_errors.php on line 2

エラー文の読み方

subtotal(): Argument #1 ($price) must be of type int, string given, called in 05_errors.php on line 18
────┬────  ─────┬───── ───┬───                 ─┬─  ─────┬─────            ──────────┬───────────
    │           │         │                     │        │                          └ 呼び出した場所
    │           │         │                     │        └ 実際に渡された型
    │           │         │                     └ 宣言されている型
    │           │         └ 引数の名前
    │           └ 何番目の引数か
    └ 関数名

「called in」の後ろのファイル名と行番号が、直す場所です。 関数の定義側ではなく、呼び出している行を見にいきます。

可変長引数で、いくつでも受け取る

引数の前に ... を付けると、渡された値をまとめて配列として受け取れます。

<?php
function sum(int ...$numbers): int
{
    return array_sum($numbers);
}
var_dump(sum());
var_dump(sum(1, 2, 3));

$list = [10, 20, 30];
var_dump(sum(...$list));          // 配列を展開して渡す

function tagLine(string $sep, string ...$tags): string
{
    return implode($sep, $tags);
}
echo tagLine(' / ', 'PHP', '関数', '引数'), PHP_EOL;

try {
    sum(1, 'x');
} catch (TypeError $e) {
    echo get_class($e), ': ', $e->getMessage(), PHP_EOL;
}

int(0)
int(6)
int(60)
PHP / 関数 / 引数
TypeError: sum(): Argument #2 must be of type int, string given, called in 07_variadic.php on line 21

可変長引数に付けた型（int）は、渡された値の1つ1つに対して確認されます。また、可変長引数は引数リストの最後にだけ置けます。途中に置くと次の表示になりました。

Fatal error: Only the last parameter can be variadic in 15_var.php on line 2

文字列キーの配列を展開したり、名前付き引数で渡したりすると、可変長引数はキーつきの配列として受け取ります。

<?php
function show(...$args) { var_dump($args); }
show(a: 1, b: 2);

array(2) {
  ["a"]=>
  int(1)
  ["b"]=>
  int(2)
}

型宣言のない時代から使われている func_get_args() も、現在の PHP で動きます（legacy(1, 2, 3) で 3:1,2,3 を確認）。新しく書くコードでは、型を付けられる ... のほうが読みやすくなります。

参照渡しで、呼び出し元の変数を書き換える

通常の引数は値渡しで、関数の中で引数を書き換えても呼び出し元の変数は変わりません。引数の前に & を付けると参照渡しになり、呼び出し元の変数そのものを書き換えます。

<?php
function addTaxByValue(int $price): void { $price = (int)($price * 1.1); }
function addTaxByRef(int &$price): void { $price = (int)($price * 1.1); }

$a = 1000; addTaxByValue($a); var_dump($a);
$b = 1000; addTaxByRef($b);  var_dump($b);

function addItem(array &$cart, string $item): void { $cart[] = $item; }
$cart = ['ペン'];
addItem($cart, 'ノート');
print_r($cart);

int(1000)
int(1100)
Array
(
    [0] => ペン
    [1] => ノート
)

値渡しの $a は 1000 のまま、参照渡しの $b は 1100 に変わりました。配列も既定では値渡しなので、関数の中で要素を追加したいときは & を付けるか、追加後の配列を return で返します。

オブジェクトを渡したときの動き

オブジェクトは & を付けなくても、関数の中でプロパティを変更すると呼び出し元に反映されます。

<?php
function renameItem(object $o): void { $o->name = '変更後'; }
function replaceItem(object $o): void { $o = new stdClass; $o->name = '差し替え'; }

$obj = new stdClass; $obj->name = '変更前';
renameItem($obj);  var_dump($obj->name);
replaceItem($obj); var_dump($obj->name);

string(9) "変更後"
string(9) "変更後"

プロパティの変更は反映されますが、引数に別のオブジェクトを代入しても、呼び出し元の変数は元のオブジェクトを指したままです。オブジェクトの場合は「同じオブジェクトを指す値」がコピーされて渡される、と考えるとこの結果を説明できます。

参照渡しには変数を渡す

参照渡しの引数に、変数ではなく値そのものを渡すと、次の表示で止まりました。

$ addTaxByRef(1000);
Fatal error: Uncaught Error: addTaxByRef(): Argument #1 ($price) could not be passed by reference in 08_ref.php:21

複数の値を返す例は次のとおりです。

<?php
function minMax(array $nums): array { return [min($nums), max($nums)]; }
[$min, $max] = minMax([3, 9, 1]);
echo "$min / $max", PHP_EOL;   // 1 / 9

まずは return で返す形を選び、参照渡しは「その場で書き換える」ことが名前から伝わる関数に絞ると、呼び出し側が読みやすくなります。

名前付き引数で、必要な引数だけを渡す

PHP 8.0 から、引数名: 値 の形で引数を渡せます。途中のデフォルト値を飛ばして、後ろの引数だけを指定できるのがいちばんの利点です。

<?php
function createUser(string $name, int $age = 20, bool $admin = false, string $lang = 'ja'): string
{
    return sprintf('%s / %d / %s / %s', $name, $age, $admin ? 'admin' : 'user', $lang);
}
echo createUser('佐藤', lang: 'en'), PHP_EOL;           // 位置引数 + 名前付き
echo createUser(admin: true, name: '鈴木'), PHP_EOL;    // 順番を入れ替え
echo createUser('田中', 30, lang: 'en'), PHP_EOL;

$args = ['name' => '高橋', 'admin' => true];
echo createUser(...$args), PHP_EOL;                     // 連想配列を展開
echo createUser(...['伊藤', 41], lang: 'en'), PHP_EOL;  // 展開の後に名前付き（8.1〜）

echo str_pad(string: '7', length: 3, pad_string: '0', pad_type: STR_PAD_LEFT), PHP_EOL;

佐藤 / 20 / user / en
鈴木 / 20 / admin / ja
田中 / 30 / user / en
高橋 / 20 / admin / ja
伊藤 / 41 / user / en
007

組み込み関数（str_pad）にも使えます。true や false が並ぶ呼び出しでは、何を指定しているのかが読み取りやすくなります。

名前付き引数のルールとエラー文

位置で渡す引数を先に、名前付き引数を後に書く、という順番だけ覚えておけば十分です。 引数名が呼び出し側のコードに現れるようになるので、公開している関数の引数名を変えるときは、呼び出し側も一緒に直します。

無名関数・アロー関数・第一級callable構文

関数を変数に入れたり、ほかの関数に渡したりする書き方です。

<?php
$rate = 0.1;

// 無名関数（クロージャ）：外の変数は use で取り込む
$withTax = function (int $price) use ($rate): int {
    return (int) round($price * (1 + $rate));
};
var_dump($withTax(1000));

// アロー関数：外の変数を自動で取り込む
$withTax2 = fn(int $price): int => (int) round($price * (1 + $rate));
var_dump($withTax2(1000));

// 定義した後で外の変数を変えても、取り込んだ値は変わらない
$rate = 0.5;
var_dump($withTax(1000));
var_dump($withTax2(1000));

int(1100)
int(1100)
int(1100)
int(1100)

無名関数の use もアロー関数も、定義した時点の値をコピーして取り込みます。 後から $rate を 0.5 に変えても、結果は 1100 のままでした。

外の変数を書き換えたいとき

<?php
// use (&$var) で参照として取り込むと、外の変数を書き換えられる
$total = 0;
$add = function (int $n) use (&$total): void { $total += $n; };
$add(5); $add(7);
var_dump($total);

// アロー関数の中で外の変数を変更しても、外には反映されない
$count = 0;
$inc = fn() => $count++;
$inc(); $inc();
var_dump($count);

// use を書かずに外の変数を使うと
$rate = 0.1;
$noUse = function () { return $rate; };
var_dump($noUse());

int(12)
int(0)
Warning: Undefined variable $rate in 10_closure.php on line 32
NULL

コールバックとして渡す

<?php
$prices = [100, 250, 400];
print_r(array_map(fn($p) => $p * 2, $prices));
print_r(array_filter($prices, fn($p) => $p >= 250));
usort($prices, fn($a, $b) => $b <=> $a);
print_r($prices);

Array ( [0] => 200 [1] => 500 [2] => 800 )
Array ( [1] => 250 [2] => 400 )
Array ( [0] => 400 [1] => 250 [2] => 100 )

（print_r の出力は、横幅を抑えるために1行にまとめて表示しています。）array_filter の結果はキーが元のまま（1 と 2）残ります。0 から振り直したいときは array_values() を通します。

第一級callable構文：既存の関数をそのまま値にする

PHP 8.1 から、関数名の後ろに (...) を付けると、その関数を Closure オブジェクトとして取り出せます。

<?php
$len = strlen(...);
var_dump($len('hello'));
var_dump($len instanceof Closure);

function double(int $n): int { return $n * 2; }
print_r(array_map(double(...), [1, 2, 3]));

class Cart {
    public function __construct(private float $rate) {}
    public function withTax(int $p): int { return (int) round($p * (1 + $this->rate)); }
    public static function label(int $p): string { return $p . '円'; }
}
$cart = new Cart(0.1);
print_r(array_map($cart->withTax(...), [100, 200]));
print_r(array_map(Cart::label(...), [100, 200]));

int(5)
bool(true)
Array ( [0] => 2 [1] => 4 [2] => 6 )
Array ( [0] => 110 [1] => 220 )
Array ( [0] => 100円 [1] => 200円 )

文字列で渡す書き方（array_map('double', [6])）も引き続き動きます。違いが出るのは、名前を打ち間違えたときです。

（array_map('doubel', [1]) を実行）
TypeError: array_map(): Argument #1 ($callback) must be a valid callback or null, function "doubel" not found or invalid function name

（$x = doubel(...); を実行）
Error: Call to undefined function doubel()

文字列は「使われた場所」で初めてエラーになりますが、(...) は書いた行でエラーになるので、原因の場所がすぐにわかります。 エディタの補完や名前の一括変更も効きやすくなります。

関数を書くときのチェックリスト

よくある質問

Q. 型宣言は必ず書いたほうがよいですか？ A. 書くことをおすすめします。型があると、渡し間違いが TypeError として呼び出した行つきで表示されるので、原因を探す時間が短くなります。どんな値でも受け取る引数には mixed と書いておくと、「型を書き忘れたのではなく、何でも受け取る」という意図が伝わります。

Q. strict_types=1 は、既存のファイルにも入れたほうがよいですか？ A. 入れると、これまで自動変換で通っていた呼び出し（'1200' を int の引数に渡すなど）が TypeError になります。今回の比較表のとおり影響する箇所が決まっているので、新しく書くファイルから入れ、既存のファイルはテストを用意したうえで1ファイルずつ進めるのがおすすめです。

Q. 関数の中から外の変数を使うにはどうすればよいですか？ A. 引数として渡すのが基本です。無名関数なら use ($変数)、アロー関数なら自動で取り込まれます。global $変数; という書き方もありますが、どこで値が変わるのかを追いにくくなるので、引数と戻り値でやり取りする形にすると読みやすくなります。

Q. デフォルト値のある引数を飛ばして、その後ろの引数だけ指定できますか？ A. 名前付き引数を使えばできます。createUser('佐藤', lang: 'en') のように書くと、間の $age と $admin はデフォルト値が使われます。

まとめ

• 関数は function 名前(型 $引数 = デフォルト値): 戻り値の型 { ... } の形で書く。型は省略できるが、書いておくと渡し間違いをその場で知らせてくれる
• 戻り値型は、返さないなら void、戻らないなら never、null もあり得るなら ?型、複数の型なら union を使う
• strict_types=1 の有無で、'1200' や true を int に渡したときの結果が変わる。float に int を渡す場合だけは両方で通る
• 任意引数は必須引数の後ろに置く。逆にすると非推奨の通知が出て、デフォルト値は使われない
• 引数の不足は ArgumentCountError、型の不一致は TypeError。エラー文の「called in」が直す場所
• 可変長引数は ...$args、参照渡しは &$arg、名前付き引数は 名前: 値。位置引数を先に書く
• 無名関数は use、アロー関数は自動で外の変数を取り込む。既存の関数は strlen(...) の形で値として渡せる

株式会社RJCでは、PHPの関数の書き方や型宣言の使い方を仲間と学び合っています。こうした知識を共有しながら、日々技術を磨いています。

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。