Laravel 설치 · 5 min read · Dec 01, 2025
우분투 20.04에 Laravel PHP 웹 프레임워크 설치하는 방법
Laravel은 웹 애플리케이션 개발을 위한 널리 사용되는 오픈 소스 PHP 프레임워크입니다. Laravel은 MVC(모델-뷰-컨트롤러) 아키텍처 패턴을 구현합니다. Laravel 프로젝트는 2011년 Taylor Otwell에 의해 CodeIgniter(CI) 프레임워크의 정교한 대안으로 시작되었습니다.
Laravel의 1 및 2 버전은 2011년에 발표되었습니다. 현재 버전 8.x에는 버전 관리 체계, 지원 정책, Blade 구성 요소 태그 및 개선 사항, 유창한 문자열 작업, 라우트 모델 바인딩 개선 사항 및 기타 개선 사항이 추가되었습니다.
이 문서에서는 우분투 20.04 서버에서 Apache 웹 서버를 사용하여 최신 Laravel 버전 8.x를 설치하는 방법을 배웁니다. 우리는 두 가지 방법으로 Linux에 Laravel 웹 프레임워크를 설치하는 방법을 가르쳐 드릴 것입니다.
전제 조건
- 우분투 20.04 시스템
- 2GB 이상의 RAM
- 루트 권한
- Debian/Ubuntu 시스템의 기본 사용법 이해
우리가 할 일
- Apache 웹 서버 설치
- PHP 7.4 설치 및 구성
- Composer PHP 패키지 관리 설치
- Laravel 웹 프레임워크 설치
- Laravel 프로젝트를 위한 Apache 가상 호스트 설정
- 테스트
1단계 - Apache 웹 서버 설치
먼저, 우분투 20.04 시스템에 Apache 웹 서버를 설치하고 SSH, HTTP 및 HTTPS를 포함한 일부 서비스에 대해서만 수신 연결을 허용하는 UFW 방화벽을 설정합니다.
시스템의 모든 사용 가능한 리포지토리를 업데이트하고 아래의 apt 명령을 사용하여 Apache 웹 서버를 설치합니다.
sudo apt update
sudo apt install apache2모든 설치가 완료되면 Apache 서비스를 시작하고 시스템 부팅 시 자동으로 시작되도록 추가합니다.
systemctl start apache2
systemctl enable apache2이제 다음 명령을 사용하여 Apache 서비스 상태를 확인합니다.
systemctl status apache2아래는 당신이 얻을 결과입니다.
결과적으로 Apache 서비스가 실행 중입니다.
다음으로, 다음 명령을 사용하여 UFW 방화벽에 SSH, HTTP 및 HTTPS 서비스를 추가합니다.
for svc in ssh http https
do
ufw allow $svc
done이제 UFW 방화벽 서비스를 활성화합니다.
sudo ufw enable계속하려면 ‘y‘를 입력하고 UFW 방화벽이 활성화되었습니다.
다음으로, 웹 브라우저를 열고 주소 표시줄에 서버 IP 주소를 입력합니다.
그리고 기본 Apache index.html 페이지를 얻을 수 있습니다.
결과적으로 Apache 웹 서버의 설치와 UFW 방화벽 구성은 완료되었습니다.
2단계 - PHP 7.4 설치 및 구성
이 단계에서는 Laravel 설치를 위해 PHP 7.4를 설치하고 구성합니다. Laravel 8.x를 설치하려면 시스템에 PHP >= 7.2.5가 있어야 합니다. 기본적으로 공식 우분투 20.04 리포지토리는 PHP 7.4 패키지를 제공합니다.
아래의 apt 명령을 사용하여 PHP 7.4 패키지를 설치합니다.
sudo apt install libapache2-mod-php php php-common php-xml php-gd php-opcache php-mbstring php-tokenizer php-json php-bcmath php-zip unzip모든 설치가 완료되면 ‘/etc/php/7.4/‘ 디렉토리로 이동하여 Apache2 웹 서버를 위한 ‘php.ini’ 구성을 편집합니다.
cd /etc/php/7.4/
vim apache2/php.ini‘cgi.fix_pathinfo’ 옵션의 주석을 제거하고 값을 ‘0’으로 변경합니다.
cgi.fix_pathinfo=0 저장하고 닫습니다.
다음으로, 새로운 ‘php.ini’ 구성을 적용하기 위해 Apache 서비스를 재시작합니다.
systemctl restart apache2결과적으로 PHP 7.4의 기본 구성이 성공적으로 완료되었습니다.
3단계 - Composer PHP 패키지 관리 설치
Composer는 PHP를 위한 의존성 관리 도구입니다. PHP 프로젝트에 추가 PHP 의존성과 라이브러리를 다운로드할 수 있게 해주는 애플리케이션 수준의 패키지 관리자입니다.
이 튜토리얼에서는 Laravel 설치를 위해 Composer를 사용할 것이며, 공식 Composer 웹사이트에서 Composer 바이너리 파일을 다운로드하여 설치합니다.
Composer의 바이너리 파일을 다운로드하고 ‘/usr/local/bin’ 디렉토리로 이동합니다.
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer그 후, 다음 명령을 사용하여 Composer 버전을 확인합니다.
composer --version아래는 당신이 얻을 결과입니다.
보시다시피, Composer PHP 패키지 관리가 우분투 시스템에 설치되었습니다.
4단계 - 우분투 20.04에 Laravel 8.x 설치
이 단계에서는 Laravel 웹 프레임워크를 설치하는 두 가지 방법을 보여줍니다. Laravel 설치 프로그램을 통해 Laravel을 설치하고 Composer를 통해 설치합니다.
- Laravel 설치 프로그램을 통한 Laravel 설치
이 유형의 설치는 Laravel 개발자에게 가장 적합합니다. Laravel 설치 프로그램을 사용하면 루트 사용자가 아닌 사용자로 Laravel을 어디에서나 설치할 수 있습니다.
이 섹션에서는 ‘hakase’라는 비루트 사용자로 Laravel 웹 프레임워크를 설치합니다.
다음 명령을 사용하여 사용자를 추가하고 비밀번호를 설정할 수 있습니다.
useradd -m -s /bin/bash hakase
passwd hakase그 후, ‘hakase’ 사용자로 로그인합니다.
su - hakase다음으로, 아래의 composer 명령을 사용하여 Laravel 설치 프로그램 패키지를 설치합니다.
composer global require laravel/installer모든 설치가 완료되면 다음과 같은 결과를 얻습니다.
보시다시피, 모든 패키지가 ‘~/.config/composer’ 디렉토리에 설치되었습니다.
다음으로, ~/.bashrc 구성 파일을 통해 ‘bin’ 디렉토리를 PATH 환경에 추가해야 합니다.
vim 편집기를 사용하여 ~/.bashrc 구성을 편집합니다.
vim ~/.bashrc다음 구성을 줄 끝에 붙여넣습니다.
export PATH="$HOME/.config/composer/vendor/bin:$PATH"저장하고 닫습니다.
이제 새로운 ~/.bashrc 구성 버전을 로드하고 $PATH 환경 변수를 확인합니다.
source ~/.bashrc
echo $PATH아래는 당신이 얻을 결과입니다.
Composer 패키지의 ‘bin’ 디렉토리가 $PATH 환경 변수에 추가되었습니다. 결과적으로 이제 ‘laravel’ 명령을 사용하여 새 프로젝트를 시작하고 생성할 수 있습니다.
결과적으로 이제 ‘laravel’ 명령을 사용하여 새 프로젝트를 생성할 수 있습니다.
‘blog’라는 이름의 새 Laravel 프로젝트를 생성하려면 아래의 laravel 명령을 실행합니다.
laravel new blog이제 ‘blog’ Laravel 프로젝트 디렉토리를 얻을 수 있습니다.
Apache 웹 서버가 Laravel 프로젝트 디렉토리에 접근할 수 있도록 하려면 프로젝트 디렉토리의 그룹 소유자를 ‘www-data’ 그룹으로 변경하고 ‘storage’ 디렉토리를 쓰기 가능하게 만듭니다.
sudo chgrp -R www-data /home/hakase/blog
sudo chmod -R 775 /home/hakase/blog/storage결과적으로 Laravel이 Laravel 설치 프로그램을 사용하여 설치되었으며, 이제 Laravel 프로젝트를 위한 Apache 가상 호스트를 구성할 준비가 되었습니다.
- Composer create-project를 통한 Laravel 설치
Laravel 웹 프레임워크를 설치하는 또 다른 방법은 Composer PHP 패키지 관리를 사용하는 것입니다.
‘/var/www/‘ 디렉토리로 이동하여 아래의 ‘composer’ 명령을 사용하여 ‘blog’라는 이름의 새 Laravel 프로젝트를 생성합니다.
cd /var/www/
composer create-project --prefer-dist laravel/laravel blog이제 ‘blog’라는 이름의 새 프로젝트 디렉토리를 얻을 수 있습니다.
다음으로, ‘blog’ 프로젝트 디렉토리의 소유권을 ‘www-data’ 사용자로 변경하고 ‘storage’ 디렉토리를 쓰기 가능하게 만듭니다.
sudo chown -R www-data:www-data /var/www/blog
sudo chmod -R 775 /var/www/blog/storage결과적으로, Composer 명령을 사용하여 Laravel 웹 프레임워크를 설치했습니다.
5단계 - Laravel 프로젝트를 위한 Apache 설정
이 단계에서는 Laravel 프로젝트를 위한 Apache 가상 호스트를 설정합니다.
이제 ‘/etc/apache/sites-available’ 디렉토리로 이동하여 vim 편집기를 사용하여 새로운 가상 호스트 구성 ‘laravel.conf’를 생성합니다.
cd /etc/apache2/sites-available/
vim laravel.conf도메인 이름과 웹 루트 디렉토리를 자신의 것으로 변경하고 구성을 붙여넣습니다.
ServerName hakase-labs.io
ServerAdmin [email protected]
DocumentRoot /home/hakase/blog/public
Options Indexes MultiViews
AllowOverride None
Require all granted
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
저장하고 닫습니다.
다음으로, 다음 명령을 사용하여 Apache 재작성 모듈과 Laravel 가상 호스트 구성을 활성화합니다.
sudo a2enmod rewrite
sudo a2ensite laravel.conf그 후, Apache 구성을 테스트하여 오류가 없는지 확인하고 Apache 서비스를 재시작합니다.
apachectl configtest
systemctl restart apache2결과적으로 Laravel을 위한 Apache 가상 호스트 구성이 완료되었습니다.
6단계 - 테스트
웹 브라우저를 열고 주소 표시줄에 서버 IP 주소 또는 도메인 이름을 입력합니다.
아래는 당신이 얻을 결과입니다.
결과적으로 Apache 웹 서버와 함께 Laravel의 설치 및 구성이 성공적으로 완료되었습니다.
참고
새 게시물을 받은 편지함에서 받기
스팸은 없습니다. 언제든지 구독 해지 가능합니다.