PHP配列（配列）

PHP の配列は実際には順序付けられたマップです。マップはキーに値を関連付けるタイプです。この型はさまざまな方法で最適化されているため、実数の配列、リスト (ベクトル)、ハッシュ テーブル (マップの実装)、ディクショナリ、セット、スタック、キューなどとして扱うことができます。さらなる可能性を。配列要素の値は別の配列にすることもできるため、ツリー構造や多次元配列も許可されます。

これらの構造の説明はこのマニュアルの範囲を超えていますが、各構造に対して少なくとも 1 つの例が提供されます。これらの構造の詳細については、この広範なトピックに関する他の著作を参照することをお勧めします。

構文

配列の定義 array()

array() 言語構造を使用して、新しい配列を作成できます。カンマで区切られた任意の数のキー => 値のペアを受け入れます。

array( key => value
, ...
)
// キーは整数または文字列にすることができます
// 値は任意のタイプの値にすることができます

最後の配列 単位の後のカンマは次のとおりです省略。通常、array(1, 2, ) の代わりに array(1, 2) などの単一行の配列定義で使用されます。新しいセルを追加しやすくするために、複数行の配列定義の最後のカンマを残すのが一般的です。

5.4 以降、array() の代わりに [] を使用する短い配列定義構文を使用できるようになりました。

例 #1 単純な配列

<?php
$array = array(
   "foo" => "bar",
   "bar" => "foo",
);
 
// 自 PHP 5.4 起
$array = [
   "foo" => "bar",
   "bar" => "foo",
];
?>

key には整数または文字列を指定できます。値は任意の型にすることができます。

さらに、キーには次の強制変換が行われます:

正当な整数値を含む文字列は整数型に変換されます。たとえば、キー名「8」は実際には 8 として保存されます。ただし、「08」は有効な 10 進数値ではないため、キャストされません。

浮動小数点数も整数に変換されます。つまり、小数部分は四捨五入されます。たとえば、キー名 8.7 は、実際には 8 として保存されます。

ブール値も整数に変換されます。つまり、キー名 true は実際には 1 として格納され、キー名 false は 0 として格納されます。

Null は空の文字列に変換されます。つまり、キー名 null は実際には "" として格納されます。

配列やオブジェクトをキー名として使用することはできません。これを強制的に実行すると、「オフセット タイプが不正です」という警告が表示されます。

複数のユニットが配列定義で同じキー名を使用している場合、最後のものだけが使用され、前のものは上書きされます。

例 #2 型強制と上書きの例

<?php
$array = array(
   1    => "a",
   "1"  => "b",
   1.5  => "c",
   true => "d",
);
var_dump($array);
?>

上記のルーチンは出力します:

array(1) {
[1]=>
string(1) "d"
}

上記の例では、すべてのキー名が強制的に 1 に設定され、新しいユニットがそれぞれ前の値と最後に残った値を上書きします。その下には「d」が 1 つだけあります。

PHP は実際にはインデックス付き配列と連想配列を区別しないため、PHP 配列には整数型と文字列型の両方のキー名を含めることができます。

指定された値にキーが指定されていない場合は、現在の最大の整数インデックス値が取得され、新しいキーはその値に 1 を加えたものになります。指定したキー名にすでに値が設定されている場合、その値は上書きされます。

例 #3 整数と文字列のキー名の混合

<?php
$array = array(
   "foo" => "bar",
   "bar" => "foo",
   100   => -100,
   -100  => 100,
);
var_dump($array);
?>

上記のルーチンは次のように出力します:

array(4) {
["foo"]=>
string(3) "bar"
["bar"]=>
string(3) "foo"
[100]=>
int(-100)
[-100]=>
int(100)
}

key はオプションです。指定しない場合、PHP は、以前に使用した最大の整数キーに 1 を加えたものを新しいキーとして自動的に使用します。

例 #4 キー名のないインデックス配列

<?php
$array = array("foo", "bar", "hallo", "world");
var_dump($array);
?>

上記のルーチンは出力します:

array(4) {
[0]=>
string(3) "foo"
[1]=>
string(3) "bar"
[2]=>
string(5) "hallo"
[3]=>
string(5) "world"
}

一部のユニットにのみキー名を指定し、その他を空白のままにすることもできます:

例 #5 一部のユニットにのみキーを指定する 名前

<?php
$array = array(
        "a",
        "b",
   6 => "c",
        "d",
);
var_dump($array);
?>

上記のルーチンは次のように出力します:

array(4) {
[0]=>
string(1) "a"
[1]=>
string(1) "b"
[6]=>
string(1) "c"
[7]=>
string(1) "d"
}

最後の値 "d" にキー名 7 が自動的に割り当てられていることがわかります。これは、以前の最大の整数キーが 6 であったためです。

配列単位にアクセスするには角かっこ構文を使用します

配列単位には、array[key] 構文を通じてアクセスできます。

例 #6 配列セルへのアクセス

<?php
$array = array(
   "foo" => "bar",
   42    => 24,
   "multi" => array(
        "dimensional" => array(
            "array" => "foo"
        )
   )
);
 
var_dump($array["foo"]);
var_dump($array[42]);
var_dump($array["multi"]["dimensional"]["array"]);
?>

上記のルーチンは次の出力を行います:

string(3) "bar"
int(24)
string(3) "foo"

注:

角括弧と中括弧は、配列セル ($array[42] や $array{42 など) にアクセスするために同じ意味で使用できます。上の例でも同じ効果です)。

PHP 5.4 以降、配列を使用して関数またはメソッド呼び出しの結果を間接的に参照できるようになりました。以前は、一時変数のみを渡すことができました。

PHP 5.5 以降、配列を使用して配列プロトタイプを間接的に参照できるようになりました。

例 #7 配列の間接参照

<?php
function getArray() {
   return array(1, 2, 3);
}
 
// on PHP 5.4
$secondElement = getArray()[1];
 
// previously
$tmp = getArray();
$secondElement = $tmp[1];
// or
list(, $secondElement) = getArray();
?>

注:

未定義の配列キーにアクセスしようとすることは、未定義の変数にアクセスすることと同じです。E_NOTICE レベルのエラー メッセージが表示され、結果は NULL になります。

作成/変更するには角かっこ構文を使用します

値を明示的に設定することで、既存の配列を変更できます。

これは、角括弧内にキー名を指定して配列に値を割り当てることで実現されます。キー名を省略することもできます。その場合は、空の角かっこ ([]) を変数名に追加します。

$arr[key] = value;
$arr[] = value;
// key 可以是 integer 或 string
// value 可以是任意类型的值

如果 $arr 还不存在，将会新建一个，这也是另一种新建数组的方法。不过并不鼓励这样做，因为如果 $arr 已经包含有值（例如来自请求变量的 string）则此值会保留而 [] 实际上代表着字符串访问运算符。初始化变量的最好方式是直接给其赋值。。

要修改某个值，通过其键名给该单元赋一个新值。要删除某键值对，对其调用 unset() 函数。

<?php
$arr = array(5 => 1, 12 => 2);
$arr[] = 56;    // This is the same as $arr[13] = 56;
               // at this point of the script
$arr["x"] = 42; // This adds a new element to
               // the array with key "x"
unset($arr[5]); // This removes the element from the array
unset($arr);    // This deletes the whole array
?>

Note:

如上所述，如果给出方括号但没有指定键名，则取当前最大整数索引值，新的键名将是该值加上 1（但是最小为 0）。如果当前还没有整数索引，则键名将为 0。

注意这里所使用的最大整数键名不一定当前就在数组中。它只要在上次数组重新生成索引后曾经存在过就行了。以下面的例子来说明：

<?php
// 创建一个简单的数组
$array = array(1, 2, 3, 4, 5);
print_r($array);
// 现在删除其中的所有元素，但保持数组本身不变:
foreach ($array as $i => $value) {
   unset($array[$i]);
}
print_r($array);
// 添加一个单元（注意新的键名是 5，而不是你可能以为的 0）
$array[] = 6;
print_r($array);
// 重新索引：
$array = array_values($array);
$array[] = 7;
print_r($array);
?>

以上例程会输出：

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

实用函数

有很多操作数组的函数，参见数组函数一节。

Note:

unset() 函数允许删除数组中的某个键。但要注意数组将不会重建索引。如果需要删除后重建索引，可以用 array_values() 函数。

d187627a39155b76819487cf772766aa 'January'
[2] => 'February'
[3] => 'March'
)

Example #12 填充数组

<?php
// fill an array with all items from a directory
$handle = opendir(&#39;.&#39;);
while (false !== ($file = readdir($handle))) {
   $files[] = $file;
}
closedir($handle);
?>

数组是有序的。也可以使用不同的排序函数来改变顺序。更多信息参见数组函数。可以用 count() 函数来数出数组中元素的个数。

Example #13 数组排序

<?php
sort($files);
print_r($files);
?>

因为数组中的值可以为任意值，也可是另一个数组。这样可以产生递归或多维数组。

Example #14 递归和多维数组

<?php
$fruits = array ( "fruits"  => array ( "a" => "orange",
                                      "b" => "banana",
                                      "c" => "apple"
                                    ),
                 "numbers" => array ( 1,
                                      2,
                                      3,
                                      4,
                                      5,
                                      6
                                    ),
                 "holes"   => array (      "first",
                                      5 => "second",
                                           "third"
                                    )
               );
 
// Some examples to address values in the array above
echo $fruits["holes"][5];    // prints "second"
echo $fruits["fruits"]["a"]; // prints "orange"
unset($fruits["holes"][0]);  // remove "first"
 
// Create a new multi-dimensional array
$juices["apple"]["green"] = "good";
?>

数组(Array) 的赋值总是会涉及到值的拷贝。使用引用运算符通过引用来拷贝数组。

<?php
$arr1 = array(2, 3);
$arr2 = $arr1;
$arr2[] = 4; // $arr2 is changed,
            // $arr1 is still array(2, 3)
$arr3 = &$arr1;
$arr3[] = 4; // now $arr1 and $arr3 are the same
?>