정의 및 사용 방법
- PHP 버전
- 4.0.4+
array_sum() 함수는 배열에 포함된 모든 요소의 값(정수 또는 부동 소수점 숫자)을 더한 합계를 계산하여 반환합니다.
이 함수를 사용하면 배열에 있는 숫자 값의 합계를 쉽게 계산할 수 있습니다.
특징
- 인덱스 배열뿐만 아니라 연관 배열에서도 요소 값을 모두 계산합니다.
- PHP 8.3.0 이전에는 요소 값이 정수 또는 부동 소수점 숫자가 아니면 해당 값은 무시하고 계산했습니다.
- PHP 8.3.0부터는 요소 값이 숫자로 자동 타입 변환되지 않거나(예: 문자열) 배열 또는 객체이면
E_WARNING경고가 발생합니다.
기본 예제
/* 1. 숫자 인덱스 배열 */
$numbers = [10, 20, 30.5];
echo array_sum($numbers); // 출력: 60.5
$numbers_type_cast = [1, '1', 1]; // 숫자로 자동 형 변환이 가능한 문자열 '1' 포함
echo array_sum($numbers_type_cast); // 출력: 3
$mixed_numbers = [10, 'hello', 30.5]; // 숫자로 자동 형 변환이 불가능한 문자열 'hello' 포함
echo array_sum($mixed_numbers);
// PHP 8.3.0 이전 출력: 40.5
// PHP 8.3.0부터 E_WARNING 경고 발생
/* 2. 연관 배열 */
$prices = ['apple' => 1000, 'banana' => 500];
echo array_sum($prices); // 출력: 1500
/* 3. 빈 배열 */
$empty = [];
echo array_sum($empty); // 출력: 0
구문
array_sum(array $array): int|float
매개변수
$array |
요소 값들을 모두 계산할 배열입니다. |
|---|
반환 값
- 배열에 포함된 모든 요소의 값(정수 또는 부동 소수점 숫자)을 더한 합계를 계산하여 반환합니다.
-
계산된 합계가 정수이면 정수 타입(
int)으로 반환합니다. -
계산된 합계가 부동 소수점 숫자이면 부동 소수점 타입(
float)으로 반환합니다.
-
계산된 합계가 정수이면 정수 타입(
- 빈 배열인 경우에는
0을 반환합니다.
변경 이력
활용 예제
array_sum() 함수는 여러 개의 숫자 데이터를 한 번에 합산할 수 있어, 합계뿐만 아니라 합산한 값을 이용한 평균이나 백분율(%) 등의 계산에도 유용하게 활용할 수 있습니다.
장바구니 상품 가격 총합 계산하기
쇼핑몰에서 고객이 담은 장바구니의 총 결제 금액을 계산하는 상황을 살펴보겠습니다. 상품 이름을 키로 하고 가격을 값으로 갖는 연관 배열이 주어졌을 때 array_sum()을 사용하면 복잡한 반복문 없이도 간단히 합계를 낼 수 있습니다.
// 사용자의 장바구니에 담긴 상품들의 가격 리스트 (연관 배열)
$cart_prices = [
'무선 키보드' => 45000,
'인체공학 마우스' => 32000,
'장패드' => 15000,
'모니터 암' => 59000
];
// array_sum을 이용해 총 결제 금액 계산
$total_price = array_sum($cart_prices);
echo "장바구니 총 결제 금액: " . number_format($total_price) . "원";
// 출력: 장바구니 총 결제 금액: 151,000원
코드 부연설명
number_format() 함수는 숫자 또는 숫자 형태의 문자열을 천 단위로 그룹화한 후 숫자 문자열로 포맷합니다.
리뷰 평점 평균(만족도) 구하기
제품이나 서비스에 대한 여러 고객의 리뷰 평점으로 평균 만족도를 계산하는 상황을 살펴보겠습니다. 여러 평점이 배열로 주어졌을 때 array_sum()으로 총점을 구하고 count()로 리뷰 개수를 확인한 후 나누면 평균 평점을 계산할 수 있습니다.
// 고객들이 남긴 리뷰 평점 배열 (1점 ~ 5점 만점)
$ratings = [5, 4, 4, 5, 3, 4, 5];
// 1. array_sum()으로 총점 계산
$total_score = array_sum($ratings);
// 2. count()로 전체 리뷰 개수 확인
$review_count = count($ratings); // count()는 배열의 길이를 반환합니다.
// 3. 평균 계산 (리뷰 개수가 0개일 때의 에러 방지 처리)
$average_rating = 0;
if ($review_count > 0) {
$average_rating = $total_score / $review_count;
}
echo "총점: {$total_score}점 | 리뷰 수: {$review_count}개<br>";
echo "평균 평점: " . $average_rating . "점";
// 출력: 총점: 30점 | 리뷰 수: 7개 / 평균 평점: 4.2857142857143점
설문조사 결과 통계 및 백분율(%) 계산
설문조사에서 각 항목에 대한 응답자 수를 배열로 관리하거나 변환해 전체 응답자 수를 구하고 각 항목이 차지하는 백분율(%)을 계산할 수 있습니다. 이때 array_sum()을 사용하면 각 항목의 응답자 수를 간단하게 합산하여 전체 응답자 수를 구할 수 있습니다.
// 설문조사 항목별 응답 수 (연관 배열)
$survey_results = [
'매우 만족' => 45,
'만족' => 30,
'보통' => 15,
'불만족' => 10
];
// 1. array_sum()으로 전체 응답자 총합 계산
$total_responses = array_sum($survey_results);
echo "전체 응답자 수: " . $total_responses . "명<br>";
// 2. 각 항목별 백분율 계산 및 출력
foreach ($survey_results as $answer => $count) {
// 항목별 응답 수를 전체 총합으로 나누어 백분율 계산
$percentage = ($count / $total_responses) * 100;
echo "{$answer}: {$count}명 ({$percentage}%)<br>";
}
/*
출력:
전체 응답자 수: 100명
매우 만족: 45명 (45%)
만족: 30명 (30%)
보통: 15명 (15%)
불만족: 10명 (10%)
*/
코드 부연설명
foreach()는 배열이나 객체를 순회해서 반복 처리하는 데 사용됩니다.