PHP 설치 방법: Windows, Mac, Linux (php -v로 확인)

PHP를 설치하려면 시스템에 맞는 명령 하나를 실행합니다. Windows는 winget install PHP.PHP.8.3, macOS는 brew install php, Ubuntu와 Debian은 sudo apt install php-cli입니다. 그런 다음 새 터미널을 열고 php -v를 실행하세요. 버전 번호가 출력되면 PHP가 설치된 것입니다.

php -v

PHP 8.3.19 (cli) (built: Mar 27 2025 11:08:15) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.3.19, Copyright (c) Zend Technologies
    with Zend OPcache v8.3.19, Copyright (c), by Zend Technologies

버전과 빌드 날짜는 다를 수 있습니다. 스크립트 안에서는 같은 정보를 PHP_VERSION과 phpversion()에서 얻습니다. Run을 눌러 이 페이지의 PHP가 무엇을 보고하는지 확인하세요.

<?php
echo "PHP version: " . phpversion() . "\n";
echo "Version as a number: " . PHP_VERSION_ID . "\n";
echo "Operating system family: " . PHP_OS_FAMILY . "\n";
echo "Integer size: " . PHP_INT_SIZE * 8 . " bit\n";

Windows에 PHP 설치

가장 빠른 방법은 Windows 10과 11에 기본 포함된 winget입니다. PowerShell이나 Windows Terminal을 여세요.

winget install PHP.PHP.8.3

터미널을 닫고 새로 연 다음 php -v를 실행하세요. 터미널은 시작할 때의 PATH를 유지하므로 새 창이 필요합니다.

직접 설치하려면 다음과 같이 합니다.

1. windows.php.net/download에서 "VS16 x64 Non Thread Safe" zip을 내려받습니다.
2. C:\php 같은 짧은 경로에 압축을 풉니다.
3. 같은 폴더에서 php.ini-development를 php.ini로 복사합니다.
4. C:\php를 Path 변수에 추가합니다(시작 메뉴, "시스템 환경 변수 편집", 환경 변수).
5. 새 터미널을 열고 php -v를 실행합니다.

Apache와 MySQL도 한 번에 설치하고 싶다면 XAMPP나 Laragon이 PHP와 함께 묶어 제공합니다.

macOS에 PHP 설치

macOS에는 더 이상 PHP가 포함되어 있지 않습니다. Homebrew로 설치하세요.

brew install php
php -v

brew install php는 최신 릴리스를 설치합니다. 버전을 고정하려면 brew install php@8.3처럼 이름으로 설치합니다. 버전이 붙은 formula는 기본적으로 링크되지 않으므로, 설치가 끝날 때 Homebrew가 출력하는 명령으로 PATH에 추가하세요. 나중에 brew upgrade php로 업데이트합니다.

Linux에 PHP 설치

Ubuntu 24.04와 Debian 13은 자체 저장소에 PHP 8.3 이상을 제공합니다.

sudo apt update
sudo apt install php-cli php-mbstring php-xml php-curl
php -v

Fedora, RHEL 및 비슷한 시스템에서는 다음과 같습니다.

sudo dnf install php-cli php-mbstring php-xml
php -v

확장 모듈은 php-<name>이라는 이름의 별도 패키지입니다. Debian과 Ubuntu에서는 php-mysql이 MySQL 드라이버를(Fedora에서는 php-mysqlnd), php-intl이 intl 확장을 추가합니다. Ubuntu에서 배포판보다 새로운 PHP가 필요하면 널리 쓰이는 ppa:ondrej/php 저장소에 지원되는 모든 버전이 있습니다.

sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php8.3-cli

코드에서 PHP 버전 확인

라이브러리는 최소 버전을 요구하는 경우가 많습니다. version_compare는 PHP 방식으로 버전 문자열을 비교하고, PHP_VERSION_ID는 비교하기 쉬운 정수를 제공합니다(80300은 8.3.0을 뜻합니다).

<?php
$required = '8.1.0';

if (version_compare(PHP_VERSION, $required, '>=')) {
    echo "PHP " . PHP_VERSION . " is new enough (need $required)\n";
} else {
    echo "Please upgrade: this code needs PHP $required\n";
}

echo PHP_VERSION_ID >= 80300 ? "8.3 features are available\n" : "Older than 8.3\n";
echo "Major: " . PHP_MAJOR_VERSION . ", minor: " . PHP_MINOR_VERSION . "\n";

설치된 확장 모듈 확인

새로 설치한 뒤 생기는 오류의 상당수는 확장 모듈이 없어서입니다. 터미널에서 php -m은 로드된 모든 확장을 나열합니다. 코드에서는 extension_loaded로 이름별로 하나씩 확인합니다.

<?php
$needed = ['mbstring', 'json', 'ctype', 'dom'];

foreach ($needed as $ext) {
    $status = extension_loaded($ext) ? 'loaded' : 'MISSING';
    printf("%-10s %s\n", $ext, $status);
}

echo "\nTotal extensions loaded: " . count(get_loaded_extensions()) . "\n";

프로젝트에 필요한 이름(예: pdo_mysql, intl, gd)을 추가하고 내 컴퓨터에서 실행해 무엇을 설치해야 하는지 확인하세요.

php.ini 찾기

display_errors, memory_limit, upload_max_filesize 같은 설정은 php.ini에 있습니다. 터미널 명령 php --ini는 어떤 파일이 로드되었는지 출력합니다. 코드에서는 다음과 같습니다.

<?php
$ini = php_ini_loaded_file();
echo $ini === false ? "No php.ini loaded, PHP uses its defaults\n" : "Loaded: $ini\n";

echo "memory_limit = " . ini_get('memory_limit') . "\n";
echo "max_execution_time = " . ini_get('max_execution_time') . "\n";

CLI와 웹 서버는 서로 다른 php.ini 파일을 쓸 수 있으므로, 한쪽에서 바꾼 설정이 다른 쪽에 항상 적용되지는 않습니다. 오류 보고 페이지에서 개발 환경에서 먼저 바꿀 만한 설정을 소개합니다.

흔한 문제: 터미널이 여전히 예전 버전을 실행

업그레이드 후 php -v가 이전 버전을 보고할 때가 있습니다. which php(macOS, Linux) 또는 where php(Windows)를 실행해 터미널이 가장 먼저 찾는 바이너리를 확인하세요. macOS에서는 설치는 되었지만 링크되지 않은 Homebrew 버전인 경우가 많고, Windows에서는 대개 XAMPP 안의 폴더처럼 Path에서 더 앞에 있는 오래된 폴더입니다. 순서를 고치고 새 터미널을 연 뒤 다시 확인하세요. 그다음 PHP 파일 실행하기로 넘어가세요.