Ubuntu에 PHP 설치하는 방법 | 버전 지정·모듈 설정·웹 서버 연동까지 완전 가이드

1. 소개

Ubuntu에서 PHP를 사용하는 이유

이 글의 대상 독자와 목적

이 글에서 알 수 있는 내용

• Ubuntu에서 PHP의 기본 설치 방법
• 여러 버전의 PHP를 설치하고 전환하는 방법
• PHP 동작 확인 및 문제 해결 방법
• Apache 및 Nginx와의 연동 설정
• 자주 사용되는 PHP 모듈 설치 방법

2. 전제 조건 및 준비

Ubuntu 버전을 확인하는 방법

lsb_release -a

cat /etc/os-release

시스템 패키지를 최신 상태로 유지하기

sudo apt update
sudo apt upgrade -y

필요한 유틸리티 설치

sudo apt install -y software-properties-common

root 권한 또는 sudo 사용

3. PHP 설치 방법

표준 저장소에서 PHP를 설치하기

sudo apt install -y php

php -v

예：

PHP 8.1.2 (cli) (built: ...)

PPA를 이용해 특정 버전을 설치하기

단계 1: PPA 저장소 추가

sudo add-apt-repository ppa:ondrej/php
sudo apt update

단계 2: 원하는 PHP 버전 설치

sudo apt install -y php8.2

단계 3: 버전 확인

php -v

4. PHP 동작 확인

명령줄(CLI) 확인

php -v

출력 예：

PHP 8.2.10 (cli) (built: Aug 23 2023 08:12:10) ( NTS )
Copyright (c) The PHP Group
Zend Engine v4.2.10, Copyright (c) Zend Technologies

웹 서버를 통한 확인(Apache인 경우)

1. 테스트 파일 생성

echo "<?php phpinfo(); ?>" | sudo tee /var/www/html/info.php

2. 브라우저로 확인

http://localhost/info.php

3. 표시 내용 확인

🔍 보충: phpinfo()의 표시 내용에는 보안상의 정보도 포함되므로, 확인 후에는 info.php 파일을 삭제해 두는 것을 권장합니다。

sudo rm /var/www/html/info.php

Nginx + PHP-FPM 확인

5. 자주 사용되는 PHP 모듈 설치

PHP 모듈이란?

sudo apt install php-모듈명

주요 PHP 모듈과 그 용도

php-mbstring(멀티바이트 문자 지원)

sudo apt install php-mbstring

php-mysql(MySQL/MariaDB와의 연결)

sudo apt install php-mysql

php-gd(이미지 처리)

sudo apt install php-gd

php-xml(XML 처리)

sudo apt install php-xml

php-curl(HTTP 통신)

sudo apt install php-curl

php-zip(압축 파일 조작)

sudo apt install php-zip

모듈 활성화와 재시작

sudo phpenmod 모듈명
sudo systemctl restart apache2

6. PHP의 버전 관리와 전환

CLI에서의 PHP 버전 전환

사용할 명령：update-alternatives

단계1：설치된 PHP 버전 확인

ls /usr/bin/php*

단계2：update-alternatives에 PHP 버전 등록（첫 번째만）

sudo update-alternatives --install /usr/bin/php php /usr/bin/php7.4 74
sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.2 82단계3：사용할 버전 선택

sudo update-alternatives --config php>

There are 2 choices for the alternative php (providing /usr/bin/php).

  Selection    Path             Priority   Status
------------------------------------------------------------
* 0            /usr/bin/php8.2   82        auto mode
  1            /usr/bin/php7.4   74        manual mode
  2            /usr/bin/php8.2   82        manual mode

Press  to keep the current choice], or type selection number:

단계4：버전 확인

php -v

Apache에서의 PHP 버전 전환

1. 모듈 확인하기

ls /etc/apache2/mods-available | grep php

2. 현재 활성화된 모듈 비활성화

sudo a2dismod php7.4

3. 새로 사용하고 싶은

sudo a2enmod php8.2

4. Apache 재시작하여 반영

sudo systemctl restart apache2

7. Apache와 Nginx와의 연동 설정

Apache와의 연동 설정(mod_php)

단계 1: Apache와 mod_php 설치

sudo apt install -y apache2 libapache2-mod-php

단계 2: Apache 재시작

sudo systemctl restart apache2

단계 3: PHP 파일 테스트

<?php
phpinfo();
?>

http://localhost/test.php

Nginx와의 연동 설정(PHP-FPM)

단계 1: Nginx와 PHP-FPM 설치

sudo apt install -y nginx php-fpm

단계 2: Nginx 설정 파일 편집

sudo nano /etc/nginx/sites-available/default

location ~ .php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.2-fpm.sock;
}

단계 3: Nginx 재시작

sudo systemctl restart nginx

단계 4: PHP 파일 동작 확인

보충: 방화벽 설정(필요에 따라)

sudo ufw allow 'Apache Full'
# 또는
sudo ufw allow 'Nginx Full'

8. 문제 해결

PHP가 정상적으로 동작하지 않음 (브라우저에 소스 코드가 표시됨)

원인

해결책

• Apache인 경우： libapache2-mod-php 가 설치되어 있고, 활성화되어 있는지 확인한 뒤 Apache를 재시작합니다.

  sudo apt install libapache2-mod-php
  sudo systemctl restart apache2

• Nginx인 경우： php-fpm 가 설치되어 있으며, Nginx 설정에서 fastcgi_pass 가 올바른 소켓 또는 포트로 지정되어 있는지 확인하십시오.

  sudo systemctl restart php8.2-fpm
  sudo systemctl restart nginx

PHP의 특정 기능을 사용할 수 없음 (함수가 정의되지 않음)

원인

해결책

• 해당 기능에 필요한 모듈(예: mbstring, xml, curl)을 설치합니다.

  sudo apt install php-mbstring php-xml php-curl

• 모듈을 활성화한 후에는 웹 서버를 재시작합니다.

  sudo systemctl restart apache2  # 또는 nginx

• 활성화된 모듈 목록 확인:

  php -m

PHP 오류가 화면에 표시되지 않음

원인

해결책

sudo nano /etc/php/8.2/apache2/php.ini

display_errors = On
error_reporting = E_ALL

sudo systemctl restart apache2

오류 로그 확인 방법

Apache인 경우：

/var/log/apache2/error.log

Nginx인 경우：

/var/log/nginx/error.log

PHP-FPM 로그 (Nginx 연동 시)：

/var/log/php8.2-fpm.log

sudo tail -f /var/log/apache2/error.log

9. 요약

본 기사 요점 정리

• Ubuntu의 버전 확인 및 준비 PHP를 올바르게 설치하기 위해서는 OS 버전 확인과 패키지 업데이트가 중요합니다.
• PHP 설치 방법은 2가지 표준 저장소에서 손쉽게 설치하는 방법과, PPA를 사용해 원하는 버전을 도입하는 방법이 있습니다.
• 설치 후 동작 확인 php -v와 phpinfo()로 CLI·Web 모두 동작 확인이 가능합니다.
• 모듈 활용으로 기능 확장 php-mbstring와 php-mysql 등 자주 사용하는 모듈을 필요에 따라 도입합니다.
• 다중 버전 전환에도 대응 update-alternatives와 Apache 모듈 전환으로 유연하게 대응 가능합니다.
• Apache/Nginx와의 연동도 중요 사용하는 웹 서버에 맞는 적절한 설정이 안정적인 동작의 핵심이 됩니다.
• 문제 발생 시 로그 확인 “PHP가 표시되지 않음”, “기능이 동작하지 않음”과 같은 문제에는 에러 로그 확인이 유효합니다.

다음에 배울 단계

• MySQL(MariaDB) 도입 및 데이터베이스 연결
• WordPress 설치 및 구축
• Laravel 등 PHP 프레임워크 도입
• HTTPS 대응 (Let’s Encrypt를 사용한 SSL 인증서 설정)
• 자동 시작·재시작 관리 (systemd 활용)

10. 자주 묻는 질문(FAQ)

Q1. Ubuntu에서 PHP 최신 버전을 설치하려면 어떻게 해야 하나요?

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

Q2. 설치한 PHP 버전을 CLI에서 전환하는 방법은?

sudo update-alternatives --config php

Q3. Apache에서 PHP가 동작하지 않아 PHP 파일을 열면 내용이 그대로 표시됩니다.

sudo apt install libapache2-mod-php
sudo systemctl restart apache2

Q4. PHP 설정 파일(php.ini)은 어디에 있나요?

• Apache용：/etc/php/8.2/apache2/php.ini
• CLI용：/etc/php/8.2/cli/php.ini

Q5. PHP 확장 모듈을 활성화하려면 어떻게 해야 하나요?

sudo phpenmod mbstring
sudo systemctl restart apache2

Q6. Nginx에서 PHP가 제대로 동작하지 않습니다. 설정 시 주의할 점은?

location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.2-fpm.sock;
}

Q7. PHP 오류가 화면에 표시되지 않습니다.

display_errors = On
error_reporting = E_ALL