Array_valuesで連想配列の値を抽出！要素の添字を再割り当て

連想配列のキーを無視して値だけを扱いたい状況はよくあります。PHPでそのニーズを簡潔に満たすのが array_values 関数です。この記事では「Array_values 連想 配列」というキーワードで検索する方が期待する内容を網羅しました。使い方、注意点、実践例、パフォーマンスの観点から理解できるよう丁寧に解説します。連想配列の値だけを取り出して、新しい数値キーを付け直したい方は必見です。

Array_values 連想 配列とは何か

PHPでの連想配列は文字列や数値のキーと値のペアから成り立ちます。array_values 連想 配列という表現は、連想配列から値だけを取り出し、キーの付き方を変えて返す操作を指すことが多いです。array_values 関数は、元の連想配列のキーを破棄し、値だけを含む新しい配列を 0 から始まる連続した数値キー付きで返します。元の順序は維持されますが、文字列や非連続数値のキーはすべて無視されます。この機能が必要な状況とは、例えば JSON 出力時にオブジェクトではなく配列を返したい場合や、配列の要素数を数える前にキーのギャップを詰めたいときなどが考えられます。

array_values の基本的な使い方と構文

array_values 関数の構文は非常にシンプルです。唯一の引数に対象配列を渡し、値だけを抽出した新しい配列を返します。その返却値は常に整数キーで、0 から始まる連続した添字になります。元の配列は変更されず、その順序を保っています。バージョン互換性も広く、PHP4 以降で利用可能です。

構文と定義

この関数の定義は次の通りです。
array_values(array $array): array。引数に連想配列やインデックス配列を渡すと、すべての値を抽出して数値添字付き配列で返します。キーはすべて破棄されます。元の配列は変更されませんが、新しい配列が生成されるためメモリが必要です。

連想配列との関係

連想配列とは、キーとして文字列や任意の整数を持つ配列のことです。array_values を使うと、そのキーは完全に無視され、値だけが抽出されます。そのため「あるキーが何か」を知りたい場合、またはキーを後で参照したい場合は、この関数を使う前に別途キーを保持する方法を取る必要があります。

戻り値の仕様

戻り値は新しい配列で、型は array。すべての値が含まれ、キーは数値で 0 から始まる連続したインデックスです。元の配列のキーは戻り値に一切含まれず、元配列の順序はそのままにされています。

実践例：array_values を使った具体的なコード

次に、実践的なコード例を見ながら理解を深めます。連想配列を使ったシナリオ、キーのギャップがある配列、多次元配列への適用など様々なケースを取り扱います。これらの例を通じて、どのように array_values が機能し、どのような結果が得られるかを確認できます。

基本例：連想配列から値だけ取得

以下のような連想配列を考えてみます。
$user = [‘name’ => ‘Alice’, ‘email’ => ‘alice@example’, ‘age’ => 30];
この配列に対して array_values を適用すると、返されるのは[‘Alice’, ‘alice@example’, 30] という配列で、キーは 0,1,2 です。文字列キーであった name,email,age は消えます。

キーにギャップがある配列での使い方

たとえば次のような配列があります。
$arr = [0 => ‘a’, 2 => ‘b’, 5 => ‘c’];
unset($arr[2]);
すると [0=>’a’,5=>’c’] のようにギャップができます。ここで array_values を使うと、[‘a’,’c’] という新しい配列になり、0 と 1 のキーが再割り当てされます。ギャップを詰めてきれいなインデックス付き配列にしたい場合に便利です。

多次元配列と値抽出

配列の要素がまた配列であるときにも array_values は応用できます。第一階層の要素を抽出して数値キーにしたり、配列マップ関数を使ってすべての内部配列に適用したりできます。たとえばユーザリストの中から名前だけを取り出すマップ処理と組み合わせて、数値キー付きの名前配列を簡潔に得ることができます。

array_values を使うべきタイミングと注意点

array_values を使うことでコードがスッキリする場面がありますが、注意しないと思わぬ副作用が発生することがあります。ここでは使うべき状況と避けるべき状況を整理し、どういうデメリットがあるかを具体的に確認します。

使うべき状況

主な場面は、順序重視で値だけ必要なときです。例えば JSON 出力時、API で配列として返したい場合、フィルタ処理でキーが飛び飛びになった配列を綺麗に再構築したい場合などです。また array_unique を使った後、重複除去で残るキーが飛ぶケースでは再割り当てによって扱いやすくなります。

注意点：キー情報の喪失

array_values を使うと、キー情報は完全に失われます。もとのキーが文字列であれ数値であれ、新しい配列には含まれません。もし後でキーを元に戻したり、キーを使って値を参照する必要があるなら、キーと値の両方を保持する別の手段が必要です。たとえば array_keys と組み合わせてマッピングを作る方法があります。

パフォーマンスに関する注意

array_values は新しい配列を生成するため、配列の要素数が多いとメモリと処理時間がかかります。非常に大きなデータセットでは、必要なところだけ処理するか、配列の構造そのものを考え直すことが重要です。PHP の最新のバージョンでは内部最適化が進んでいますが、それでも O(n) のコストがかかることは避けられません。

array_values と他の関連関数との比較

array_values に似た機能を持つ他の関数とどう違うかを知っておくと、最適な選択ができます。ここでは array_keys、array_filter、array_unique、array_combine などと比較して、どのような用途が適しているかを表形式で整理します。

応用例：実務での利用シーン

array_values は単なる関数以上の役割を果たします。実務でどのように使われているかを見れば、コード設計やデータ処理のヒントが得られます。ここでは、API、フロントエンド、データベース、フィルタ処理など具体的なケースを見ていきます。

JSON API レスポンスの正規化

API で配列を返す際、連想配列だとクライアント側でオブジェクトとして扱われてしまうことがあります。レスポンスで配列として扱いたい場合は、array_values を使って値だけの配列を返すことで、確実に配列形式となります。これにより JavaScript の配列操作や型チェックがスムーズになります。

フィルタや検索後のギャップ処理

array_filter や unset を使った後、配列キーが飛び飛びになることがあります。この状態だと foreach やループでの index が思い通りにならないことがあります。array_values を組み合わせて使うと、きれいに 0 から始まる連続キーを持つ配列に戻せます。これによって UI 用配列や CSV 出力時の混乱を防げます。

重複値の削除後の再インデックス付け

array_unique を使った場合、重複する値だけが除かれますが、キーは維持されるため非連続になります。見た目や扱いが不安定になることがあります。そこで array_values を使ってキーを再割り当てすることで、整った配列となり処理も簡単になります。

実践：連想配列のキーを保持しつつ値と添字の関係を扱う方法

array_values を使うとキーが消失するので、キーを失いたくないケースもあります。キーと添字の対応を取得したい場合など、その双方を扱うためのテクニックを紹介します。キーと値の両方を効率的に扱う設計が理解できます。

array_keys と組み合わせてマップを作る

元の配列から array_keys を使ってキー一覧を取得し、それと array_values の結果を組み合わせてマッピング配列を作ることができます。例えば元のキーが name,email などの文字列であっても、それを値配列の何番目の要素に対応するかを保持するマップを作成すれば、元の情報を参照しながら値を扱えます。

array_map を使った内部配列の変換

多次元配列の中で、内部配列自体が連想配列になっている場合があります。このような場合、array_map を使って内部配列それぞれに array_values を適用できます。外側の配列も必要なら array_values を使うことで、完全に数値キーだけの多次元配列へ変換できます。

キー情報を保持しつつ出力する構造への変換

キーと値の両方が重要なときは、単純に array_values を使うのではなく、各要素を連想配列として [‘key’=>…, ‘value’=>…] の形に変換する方法が有効です。array_keys と array_values を使って構造化すれば、JSON 出力やログ出力でもキーと値が明確で扱いやすくなります。

最新情報と PHP のバージョンによる影響

PHP のバージョンアップにともない、array_values の基本動作には大きな変更はありませんが、パフォーマンス最適化や内部構造の変更により大規模データでの挙動に注目され始めています。最新環境での注意点や改善点を把握しておくと安心です。

最新 PHP バージョンでの最適化

PHP の最新バージョンでは、配列操作全般でメモリ効率と処理速度が改善されています。array_values による新しい配列生成のコストは依然として存在しますが、小規模～中規模であればほぼ気にならないレベルです。大規模な配列では遅延評価や分割処理を併用する設計が勧められます。

大規模データでの注意点

数十万～百万件規模の配列を処理する場合、array_values が作るコピーのメモリ使用量が問題になることがあります。このような時は、必要な部分だけを抽出するフィルタ処理やストリーム処理を検討するか、データベース側で値だけを取得して送る設計を採るとよいでしょう。

互換性とバグ回避

古い PHP バージョンでも array_values はサポートされていますが、一部のバージョンや拡張モジュールで配列の挙動が意図通りにならない例が報告されています。特に数値文字列キーや混合キーを持つ配列で想定外の結果を得ることがあるため、テストを書いて期待する出力を確かめることが重要です。

よくある質問（FAQ）

array_values を使う際によく寄せられる疑問とその回答をまとめます。具体的な質問形式で、迷いがちな点を把握しやすくしました。

Q：キーに意味があるデータで使ってもいいか

意味あるキー（ユーザIDやタイムスタンプなど）を持つデータで array_values を使うとキーが失われてしまいます。キー情報が重要な場合は使うべきではありません。必要であればキーと値両方を保持する構造に変換するか、キーを別のフィールドとして添付する方法を取ってください。

Q：数値キーと文字列キーが混在する配列での動作はどうなるか

混在したキーを持つ配列に array_values を適用すると、キーはすべて破棄されます。結果の配列のすべての要素は値だけで、0 から始まる数値キーが再割り当てされます。混在したキーを区別する必要のある処理では使わないか、変換後に識別可能な構造へ整形してください。

Q：array_values では順序が変わることがあるか

原則として array_values は元配列の順序を保持します。foreach や内部の反復順序に従って値を取り出すため、元の順序に依存する処理で使って問題ありません。ただし、ソート関数などでキー・値ペアの順序を変えた後に使う場合、その変更が残りますので注意が必要です。

まとめ

array_values は、連想配列から値だけを抽出し、数値インデックスで再割り当てされたきれいで扱いやすい配列を得るための非常に有用な関数です。順序を維持しながらキーを破棄する動作は、出力フォーマットや配列の再構築を簡単にします。キーが重要なデータには使わない、また大規模データではメモリ・時間のコストに注意するというポイントを心得れば、安全に利用できるでしょう。

連想配列からリストに変換したい、キーのギャップを詰めたい、API レスポンスを配列形式にしたいといった場面ではまず array_values を検討してください。他の関数との組み合わせでより柔軟に、意図通りの配列操作が可能になります。