우분투 PHP 설치 및 Nginx 연동 가이드

우분투 PHP 설치 및 Nginx 연동 가이드

1. PHP 설치

(1) 패키지 업데이트

sudo apt update

(2) PHP 및 필수 모듈 설치

PHP와 기본적으로 많이 사용하는 모듈을 한 번에 설치합니다.

sudo apt install -y php php-fpm php-cli php-mysql php-xml php-curl php-mbstring php-zip php-gd

이 명령으로 PHP와 다음 모듈들이 설치됩니다:

• php-fpm: PHP-FPM 서비스 (Nginx와 연동)
• php-cli: 명령줄에서 PHP 실행
• php-mysql: MySQL 데이터베이스 연동
• php-xml: XML 처리
• php-curl: HTTP 요청
• php-mbstring: 멀티바이트 문자열 처리
• php-zip: 압축 파일 처리
• php-gd: 이미지 처리

(3) PHP 버전 확인

PHP가 정상적으로 설치되었는지 확인합니다.

php -v

3. Nginx와 PHP 연동

(1) Nginx 설정 파일 수정

PHP 요청을 처리하도록 Nginx 설정을 변경합니다. Nginx의 기본 설정 파일을 열어 수정합니다.

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

(2) Nginx 설정 파일 수정

 

server {
    listen 80;
    server_name your_domain_or_ip;

    # 웹 서버의 루트 디렉토리 설정
    root /var/www/html;
    index index.php index.html index.htm;

    # 기본 요청 처리
    location / {
        try_files $uri $uri/ =404;
    }

    # PHP 파일 요청 처리
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock; # PHP 버전에 맞게 경로 수정
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    # .htaccess 파일 비활성화 (보안)
    location ~ /\.ht {
        deny all;
    }
}

참고: fastcgi_pass의 경로는 PHP-FPM 버전에 따라 다릅니다. 올바른 경로인지 확인하려면 아래 명령어를 실행하세요:

ls /run/php/

(3) Nginx와 PHP-FPM 재시작

설정을 저장한 후, Nginx와 PHP-FPM 서비스를 재시작합니다.

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

4. PHP 동작 테스트

(1) 테스트 파일 생성

PHP가 제대로 동작하는지 확인하기 위해 /var/www/html 디렉토리에 테스트 파일을 만듭니다.

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

(2)브라우저에서 확인

브라우저에서 다음 주소로 접속합니다:

http://your_server_ip/info.php

PHP 정보 페이지가 표시되면 PHP와 Nginx 연동이 완료된 것입니다.