우분투에서 PHP 설치 및 Apache 연동 방법 완벽 가이드

우분투에서 PHP 설치 및 Apache 연동 방법 완벽 가이드

초보자도 쉽게 따라 할 수 있는 우분투 환경에서 PHP 설치와 Apache 연동 방법을 소개합니다. 서버 환경을 처음 설정하거나 웹 개발을 시작하려는 분들에게 꼭 필요한 내용을 담았습니다. 하나씩 따라 하면서 자신만의 서버를 구축해보세요!

1. PHP와 Apache란?

웹 개발에서 PHP와 Apache는 가장 많이 사용되는 조합입니다. 우선 두 가지의 역할을 간단히 알아볼까요?

• PHP: 서버에서 실행되는 스크립트 언어로, 동적인 웹 페이지를 생성하거나 데이터베이스와 상호작용하는 데 사용됩니다.
• Apache: 가장 널리 사용되는 웹 서버 소프트웨어로, 브라우저의 요청을 받아 웹 페이지를 사용자에게 전달하는 역할을 합니다.

이 둘을 함께 사용하면 PHP로 작성된 코드를 실행하고, 결과를 브라우저에 표시할 수 있습니다.

2. PHP 설치하기

우분투에서 PHP를 설치하려면 간단한 명령어만으로 가능합니다.

1) 패키지 목록 업데이트

최신 소프트웨어를 설치하기 위해 아래 명령어를 실행합니다:

sudo apt update
sudo apt upgrade -y

2) PHP 및 필수 모듈 설치

PHP와 함께 자주 사용하는 모듈을 설치합니다. 예를 들어 PHP 8.1을 설치하려면 다음 명령어를 입력하세요:

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

설치가 완료되면 PHP 버전을 확인하여 정상적으로 설치되었는지 확인합니다:

php -v

3. Apache와 PHP 연동하기

PHP와 Apache를 연동하려면 libapache2-mod-php라는 모듈을 설치해야 합니다.

1) Apache PHP 모듈 설치

아래 명령어를 입력하여 PHP 모듈을 설치합니다:

sudo apt install libapache2-mod-php -y

2) PHP 모듈 활성화

PHP 모듈을 Apache에 활성화하려면 다음 명령어를 실행합니다:

sudo a2enmod php

3) Apache 재시작

설정을 적용하려면 Apache를 재시작합니다:

sudo systemctl restart apache2

4) PHP 모듈 활성화 확인

PHP 모듈이 제대로 활성화되었는지 확인하려면 다음 명령어를 입력하세요:

sudo apachectl -M | grep php

출력 결과에 php_module이 표시되면 성공적으로 연동된 것입니다.

4. PHP 테스트 페이지 생성

Apache와 PHP가 정상적으로 연동되었는지 확인하려면 테스트 파일을 만들어 확인합니다.

1) 테스트 파일 생성

Apache의 기본 문서 루트(/var/www/html/)에 테스트 파일을 생성합니다:

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

2) PHP 코드 작성

아래 내용을 입력한 뒤 저장합니다:

<?php
phpinfo();
?>

3) 브라우저에서 확인

서버의 IP 주소 또는 도메인을 입력하고 /info.php로 접속합니다.
예: http://서버IP주소/info.php
PHP 정보 페이지가 표시되면 설치와 연동이 완료된 것입니다.

5. PHP 설정 변경 (선택 사항)

PHP 설정 파일을 수정하여 환경을 원하는 대로 조정할 수 있습니다.

1) 설정 파일 위치

PHP 설정 파일은 /etc/php/8.1/apache2/php.ini에 위치합니다. 아래 명령어로 파일을 열어 수정합니다:

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

2) 자주 변경하는 설정 항목

• 파일 업로드 크기
  upload_max_filesize와 post_max_size 값을 조정하여 업로드 가능한 파일 크기를 설정합니다.
• 메모리 제한
  memory_limit 값을 늘려 더 많은 리소스를 사용할 수 있도록 설정합니다.

3) 설정 적용

수정 후에는 Apache를 재시작해야 변경 사항이 적용됩니다:

sudo systemctl restart apache2

---

6. 문제 해결

1) PHP 파일이 다운로드되거나 빈 화면이 표시될 때

PHP 모듈이 제대로 활성화되지 않았을 수 있습니다. 아래 명령어를 실행해 문제를 해결하세요:

sudo a2enmod php
sudo systemctl restart apache2

2) Apache 문서 루트 경로가 다른 경우

Apache 기본 문서 루트가 /var/www/html/가 아니라면 설정 파일(/etc/apache2/sites-available/000-default.conf)을 열어 DocumentRoot를 확인하고 수정하세요.

sudo nano /etc/apache2/sites-available/000-default.conf

수정 후 Apache를 재시작합니다.

우분투에서 PHP 설치 및 Apache 연동 방법  동영상 설명