関数の概要
array_count_values は、PHPの配列に含まれる値の出現回数をカウントするための便利な関数です。配列の各要素の値をキーとして、その値が配列内に何回現れたかを数え、連想配列で返します。データ分析や集計処理でよく使われる関数です。
パラメータの説明
array（必須）: 要素の出現回数を数えたい配列を指定します。配列の値はスカラー型（整数、文字列など）である必要があります。
戻り値
配列内の値をキー、その出現回数を値とした連想配列を返します。もし入力配列が空の場合は空の配列を返します。
使用例
基本的な使い方
<?php
$fruits = ['apple', 'banana', 'apple', 'orange', 'banana', 'apple'];
$result = array_count_values($fruits);
print_r($result);
?>
この例では、配列内の各果物の出現回数を数えます。結果は以下のようになります。
Array
(
[apple] => 3
[banana] => 2
[orange] => 1
)
数値の配列で使う例
<?php
$numbers = [1, 2, 2, 3, 3, 3, 4];
$result = array_count_values($numbers);
print_r($result);
?>
配列の数値が何回登場するかをカウントし、結果は以下のようになります。
Array
(
[1] => 1
[2] => 2
[3] => 3
[4] => 1
)
空の配列を渡した場合
<?php
$empty = [];
$result = array_count_values($empty);
var_dump($result);
?>
空の配列を渡すと空の配列が返されます。
array(0) {
}
注意点
配列の値が配列やオブジェクトなどの複雑な型の場合はエラーになります。必ずスカラー値（文字列、整数、浮動小数点数など）を渡しましょう。
関連する関数
array_unique: 配列の中から重複する値を取り除くarray_keys: 配列のキーを取得するarray_values: 配列の値を取得するcount: 配列の要素数を数える
まとめ
array_count_values は、配列内の各値が何回登場するかを簡単にカウントできるPHPの便利な関数です。データの集計やレポート作成で役に立ち、シンプルな構文で初心者にも使いやすいです。実務の配列操作でもぜひ活用してください。
