array_keys() 함수

array_keys() 함수는
배열의 모든 키(keys)를 배열로 추출하여 반환합니다.
필터를 적용해서 원하는 키(keys)만을 추출하여 반환할 수도 있습니다.

PHP 
$fruits = [
	'apple' => 'red',
	'banana' => 'yellow',
	'grape' => 'purple',
	'cherry' => 'red'
];

/* 배열의 모든 키(keys)를 배열로 추출하여 반환합니다. */
$fruits_keys = array_keys($fruits);

print_r($fruits_keys);
// 출력: Array ( [0] => apple [1] => banana [2] => grape [3] => cherry )

/* 원하는 키 값만을 반환하도록 필터(특정 값을 가지는 키)를 적용할 수도 있습니다. */
$red_fruits_keys = array_keys($fruits, 'red'); // 'red' 값을 가지는 키(keys)만을 반환합니다.

print_r($red_fruits_keys);
// 출력: Array ( [0] => apple [1] => cherry )

array_keys() 함수의 형식은 다음과 같습니다.

구문

PHP 
array_keys(array $array, mixed $filter_value, bool $strict = false): array

매개변수

array_keys() 함수의 매개변수 설명
$array 키(keys)를 추출할 배열입니다.
$filter_value 옵션. 지정된 값과 일치하는 키(keys)만을 필터링하기 위한 값입니다.
이 매개변수를 생략하면 배열의 모든 키를 반환합니다.
$strict 옵션. $filter_value 변수의 값이 자료형까지 일치할지 여부(true, false)를 지정합니다.
만약에 $strict 변수를
  • false로 설정한다면 숫자 2와 문자열 '2'는 같습니다.
  • true로 설정한다면 숫자 2와 문자열 '2'는 같지 않습니다.

반환 값

배열의 모든 키(keys)를 배열로 추출하여 반환합니다.
필터를 지정할 경우 지정된 값과 일치하는 키(keys)만 추출하여 배열로 반환합니다.

PHP array_keys() 함수의 반환 값 사례 
/* 연관 배열 */
$array_1 = [
	0 => 100,
	'color' => 'green'
];

print_r(array_keys($array_1)); // 출력: Array ( [0] => 0 [1] => color )

// 해당하는 키가 없으면 빈 배열을 반환합니다.
print_r(array_keys($array_1, 'blue')); // 출력: Array ( )


/* 일반 배열 */
$array_2 = ['red', 'blue', 'green', 'red'];

// 일반 배열일 경우 키는 인덱스(Index)가 반환됩니다.
print_r(array_keys($array_2, 'red')); // 출력: Array ( [0] => 0 [1] => 3 )

/* 다차원 배열 */
$array_3 = [
	'color' => ['red', 'green', 'blue'],
	'size' => ['small', 'medium', 'large']
];

print_r(array_keys($array_3)); // 출력: Array ( [0] => color [1] => size )

유용한 예제

array_keys() 함수의 유용한 예제입니다.

배열의 모든 키를 순회하는 예제

PHP 
// 배열을 생성합니다.
$array = [
    'a' => 1,
    'b' => 2,
    'c' => 3
];

// array_keys() 함수를 사용하여 배열의 모든 키를 순회합니다.
foreach (array_keys($array) as $key) {
    echo "키: {$key}, 값: {$array[$key]}";
}

// 출력:
// '키: a, 값: 1'
// '키: b, 값: 2'
// '키: c, 값: 3'

이 예제는 배열의 모든 키를 순회하는 방법을 보여줍니다. array_keys() 함수를 사용하여 배열의 모든 키를 배열로 반환한 다음, foreach() 반복문을 사용하여 키를 순회합니다.

PHP foreach() 반복문

특정 값과 일치하는 키만을 순회하는 예제

PHP 
// 배열을 생성합니다.
$array = [
    'a' => 1,
    'b' => 2,
    'c' => 3
];

// array_keys() 함수를 사용하여 값이 2인 키를 순회합니다.
foreach (array_keys($array, 2) as $key) {
    echo "키: {$key}, 값: {$array[$key]}";
}

// 출력:'키: b, 값: 2'

이 예제는 특정 값과 일치하는 키만을 순회하는 방법을 보여줍니다. array_keys() 함수의 두 번째 매개변수를 사용하여 특정 값과 일치하는 키를 반환합니다.

연관 배열의 키를 다른 배열로 변환하는 예제

PHP 
// 배열을 생성합니다.
$array = [
    'a' => 1,
    'b' => 2,
    'c' => 3
];

// array_keys() 함수를 사용하여 배열의 키를 다른 배열로 변환합니다.
$keys = array_keys($array);

// 변환된 배열을 출력합니다.
print_r($keys); // 출력: Array ( [0] => a [1] => b [2] => c )

이 예제는 배열의 키값을 다른 배열로 변환하는 방법을 보여줍니다. array_keys() 함수를 사용하여 배열의 키를 배열로 반환합니다.

array_keys() 함수를 사용하지 않고도 대부분의 작업을 foreach() 반복문으로 처리할 수 있지만, array_keys() 함수는 키 목록을 추출하는 데 특히 유용하며, 작업의 목적 및 편의성에 따라 선택해야 합니다.

참고문헌

같이 보기