정의 및 사용 방법
- PHP 버전
- 4+
array_count_values() 함수는 배열 요소들의 값 중 동일한 값이 몇 번 등장했는지 계산합니다.
각 값과 등장 횟수를 키와 값의 쌍으로 구성해 연관 배열로 반환합니다.
이 함수는 배열 데이터를 활용해 특정 값의 개수를 조회 또는 집계할 때 유용합니다.
특징
- 원본 배열은 그대로 유지되고, 새로운 연관 배열을 반환합니다.
- 문자열이나 정수가 아닌 배열 요소가 있으면
E_WARNING을 발생시킵니다. - 등장 횟수는 정수 타입으로 반환됩니다.
기본 예제
// 투표 결과나 설문 조사 응답 데이터가 배열로 있다고 가정해 봅시다.
$votes = ['apple', 'banana', 'apple', 'orange', 'banana', 'apple'];
// 각 과일이 몇 표씩 나왔는지(몇 번 등장했는지) 집계합니다.
$result = array_count_values($votes);
print_r($result);
Array
(
[apple] => 3
[banana] => 2
[orange] => 1
)
구문
array_count_values(array $array): array
매개변수
$array |
값들(values)의 등장 횟수 계산할 배열입니다. |
|---|
반환 값
배열의 값을 키(key)로, 해당 값의 등장 횟수를 값(value)으로 가지는 연관 배열을 반환합니다.
문자열이나 정수가 아닌 배열 요소가 있으면 E_WARNING을 발생시킵니다.
주의할 점
array_count_values() 함수는 배열 요소들의 값에 대해 멀티바이트 문자열(한글, 일본어 등 UTF-8 문자)을 정상적으로 처리하지만, 알파벳의 대소문자를 구분합니다.
$fruits = ['Apple', 'apple', 'APPLE', '사과'];
$result = array_count_values($fruits);
print_r($result);
Array
(
[Apple] => 1
[apple] => 1
[APPLE] => 1
[사과] => 1
)
활용 예제
array_count_values() 함수는 기본 예제에서 다룬 "투표 결과나 설문 조사 응답 데이터 집계" 뿐만 아니라, 다음과 같은 경우 유용하게 사용할 수 있습니다.
웹사이트 인기 태그 순위 만들기 (블로그/커머스)
사용자들이 게시글에 남긴 태그들을 모아서 가장 많이 사용된 태그 순위를 뽑을 때 유용합니다.
// 전체 게시글에 등록된 태그 목록 (중복 있음)
$all_tags = ['PHP', 'HTML', 'PHP', 'CSS', 'JavaScript', 'PHP', 'CSS'];
// 1. 태그별 등장 횟수 계산
$tag_counts = array_count_values($all_tags);
// 2. 많이 남긴 순서(내림차순)로 정렬
arsort($tag_counts);
print_r($tag_counts);
코드 부연설명
arsort() 함수는 연관 배열의 값을 숫자나 알파벳 기준으로 내림차순 정렬합니다.
이때 키와 값의 쌍은 그대로 유지합니다.
Array
(
[PHP] => 3
[CSS] => 2
[HTML] => 1
[JavaScript] => 1
)
홈페이지 방문 기록 분석
사용자들이 방문한 웹사이트의 각 페이지별 조회 횟수를 집계할 때 유용합니다.
$pages = [
"/home",
"/product",
"/home",
"/about",
"/product",
"/home"
];
$result = array_count_values($pages);
print_r($result);
Array
(
[/home] => 3
[/product] => 2
[/about] => 1
)