정의 및 사용 방법

PHP 버전
4+

ucfirst() 함수는
주어진 문자열의 첫 문자를 대문자로 변환하고 나머지는 그대로 유지해서 반환합니다.
이때 주어진 원본 문자열은 변경되지 않습니다.

주로 클래스명/파일명, 템플릿 등에서 간단한 문자열 포맷 규칙을 맞출 때 사용됩니다.

기본 예제

PHP 
$original_string_1 = 'hello, world!';
$ucfirst_string_1 = ucfirst($original_string_1);
echo $ucfirst_string_1; // 출력: 'Hello, world!'

$original_string_2 = 'heLLO';
$ucfirst_string_2 = ucfirst($original_string_2);
echo $ucfirst_string_2; // 출력: 'HeLLO'

주어진 문자열을 모두 대문자로 변환하려면 strtoupper() 함수를 사용하세요.

구문

PHP 
ucfirst(string $string): string

매개변수

ucfirst() 함수의 매개변수
$string 주어진 문자열입니다.

반환 값

주어진 문자열의 첫 문자를 대문자로 변환하고 나머지는 그대로 유지해서 반환합니다.
반환만 하기 때문에 주어진 원본 문자열은 변경되지 않습니다.

변경 이력

ucfirst() 함수의 변경 이력
버전설명
8.2.0 PHP 8.2.0 이전에는 setlocale()에 따라 설정에 따라 일부 문자의 대소문자 변환이 달라질 수 있었습니다. PHP 8.2.0부터는 오직 ASCII 문자만 변환되며, 멀티바이트 문자는 변환되지 않습니다.

활용 예제

ucfirst() 함수는 주로 클래스명/파일명, 템플릿 등에서 간단한 문자열 포맷 규칙을 맞출 때 사용됩니다.

참고하세요!
웹 브라우저에서 출력되는 문자열에는 ucfirst() 함수를 사용한 문자열 변환보다는 편의성이나, 스타일의 유연성 등을 고려해 CSS로 문자열을 변환하는게 더 일반적입니다.

네임스페이스 규칙에 활용 - 클래스명/파일명

PHP 프로젝트에서 오토로드(autoload)를 사용하는 경우가 많습니다. 이때, 현대적인 코딩 규칙은 협업, Composer와 같은 의존성 도구 활용, 향후 유지보수에서 매우 중요합니다.

네임스페이스와 하위 디렉토리 이름, 클래스 이름과 파일 이름은 대소문자까지 정확히 일치해야 하며, 이는 다양한 운영체제에서 발생할 수 있는 잠재적 문제를 방지합니다. 오토로드(autoload)에서 클래스명/파일명을 생성할 때 첫 글자를 대문자로 만들어야 하므로 ucfirst() 함수가 매우 유용하게 활용됩니다.

예제
PHP 
// 1. 외부 입력 또는 URL 경로에서 소문자 문자열을 받습니다.
$path = 'user';

// 2. 네임스페이스를 정의합니다. (클래스가 위치한 경로)
$namespace = 'App\\Controllers\\';

// 3. ucfirst()를 사용하여 소문자 경로를 클래스명 표준(대문자 시작)에 맞춥니다.
$class_segment = ucfirst($path); // 'User'

// 4. 네임스페이스, 변환된 클래스명, 접미사를 결합하여 최종 클래스명을 완성합니다.
$full_class = $namespace . $class_segment . 'Controller';

echo "최종 클래스명: " . $full_class . "\n"; 
// 출력: 'App\Controllers\UserController'
  • 외부 입력(user)을 클래스명 표준 규칙(User)으로 변환
  • 네임스페이스와 접미사(Controller)를 결합하여 PSR-4 자동 로딩 규칙에 맞는 클래스명을 완성
  • ucfirst() 함수 덕분에 첫 글자 대문자 변환을 손쉽게 적용

PDF/엑셀 등 서버 생성 탬플릿 제목 포맷

서버에서 PDF나 엑셀 같은 탬플릿 문서를 생성할 때, 문서의 제목이나 헤더를 일관되게 포맷하는 것이 중요합니다. ucfirst() 함수를 사용하면 문자열의 첫 글자를 쉽게 대문자로 바꿔, 문서 제목의 규격과 일관성을 유지할 수 있습니다.

예제
PHP 
$report_title = 'monthly sales';
$formatted_title = ucfirst($report_title); // 첫 글자를 대문자로 변환
echo $formatted_title; // Monthly sales
  • $report_title는 원본 문자열, $formatted_title에는 첫 글자가 대문자로 변환된 문자열이 저장
  • 서버에서 생성되는 PDF/엑셀 문서의 제목이나 헤더를 일관되게 포맷할 때 유용

주의할 점

ucfirst() 함수를 사용할 때에는 다음의 내용을 참고하세요.

다국어 지원 문제

ucfirst() 함수는 기본적으로 ASCII 문자를 처리합니다. 그래서 영어를 비롯한 일부 언어에서는 제대로 동작하지만, 유니코드를 사용하는 독일어의 ä 같은 문자열에서는 예상과 다른 결과가 나올 수 있습니다.

ASCII(American Standard Code for Information Interchange) 문자는 영어 알파벳, 숫자, 일부 특수 기호 등의 문자들을 포함하고 있습니다.

알바벳만이 아닌 다국어 문자를 처리하려면 mb_ucfirst() 함수(다국어 문자열 변환용)의 사용을 사용을 고려해 볼 수 있습니다.

원본 문자열 변경 없음

ucfirst() 함수는 입력된 문자열을 직접 변경하지 않고, 변환된 새로운 문자열을 반환합니다. 따라서 원본 문자열을 변경하고 싶다면, 반환된 값을 다시 변수에 할당해야 합니다.

PHP 
$text = 'hello';
ucfirst($text);
echo $text; // 출력: 'hello' (변경되지 않음)

$text = ucfirst($text);
echo $text; // 출력: 'Hello'

참고문헌

같이 보기