프레임워크 설치 · 2 min read · Nov 26, 2025
우분투 16.04에서 아파치용 라라벨 PHP 프레임워크 설치하기
Laravel은 애플리케이션의 간편한 개발을 목표로 하는 매우 인기 있는 오픈 소스 PHP 프레임워크입니다. 새로운 PHP 프레임워크를 시도해보고 싶다면 Laravel을 사용해보세요.
다음 가이드는 Ubuntu 16.04 LTS 기반의 Apache 서버에서 Laravel을 설치하고 실행하는 방법을 보여줍니다. 이 튜토리얼은 Ubuntu 17.x에서도 작동하지만, 서버에서는 현재의 Ubuntu 16.04 LTS와 같은 Ubuntu LTS 릴리스를 사용하는 것이 좋습니다.
사전 요구 사항
설치를 진행하기 전에 소스와 기존 소프트웨어가 업데이트되었는지 확인하는 것이 항상 좋은 아이디어입니다.
sudo apt-get update
sudo apt-get upgrade이 가이드에서는 Ubuntu 기반의 기본 서버가 실행되고 있다고 가정합니다. Laravel을 설치하기 전에 필수 구성 요소를 설치해야 합니다.
PHP 7.1 설치하기
다음 단계는 Laravel 작업에 유용한 여러 추가 패키지와 함께 PHP를 설치하는 것입니다.
sudo add-apt-repository ppa:ondrej/php
sudo apt-get update
sudo apt-get install php7.1 php7.1-mcrypt php7.1-xml php7.1-gd php7.1-opcache php7.1-mbstringUbuntu의 자체 저장소에 PHP가 있지만, 더 자주 업데이트되는 3rd 파티 저장소를 추가하는 것이 좋습니다. 원하신다면 이 단계를 건너뛰고 Ubuntu의 버전을 사용할 수 있습니다.
아파치 설치하기
이제 아파치 서버를 설치할 시간입니다. PHP와 아파치를 연결하기 위해 libapache2-mod-php7.1 패키지도 설치해야 합니다.
sudo apt-get install apache2 libapache2-mod-php7.1Laravel 설치하기
마지막으로 Laravel을 설치하기 전에 Git 버전 관리가 설치되어 있어야 합니다. 이미 설치되어 있다면 다음 단계를 건너뛰어도 됩니다. 설치되어 있지 않다면, 먼저 설정하는 방법에 대한 가이드를 따르세요.
Laravel을 설치하기 위해 먼저 Composer를 설치해야 합니다. Composer는 PHP의 의존성 관리를 위한 도구로, 패키지와 관련된 모든 필수 라이브러리를 하나로 패키징할 수 있게 해줍니다. Laravel과 모든 의존성을 설치하려면 Composer가 필요합니다. Composer는 Laravel 프레임워크를 실행하는 데 필요한 모든 것을 다운로드하고 설치합니다. Composer를 설치하려면 다음 명령을 입력하세요.
cd /tmp
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composercurl 명령은 composer.phar 패키지를 /tmp 디렉토리에 다운로드합니다. 그러나 composer를 전역적으로 실행할 수 있도록 /usr/local/bin 디렉토리로 이동해야 합니다. 이제 어디서든 composer를 실행할 수 있습니다.
Laravel을 설치하려면 시스템의 공개 HTML 디렉토리로 이동합니다. Ubuntu에서 Apache를 사용하고 있으므로 /var/www/html 디렉토리에 설치합니다.
cd /var/www/html
sudo composer create-project laravel/laravel your-project --prefer-dist위 명령은 Laravel 설치가 포함된 “ your-project “ 디렉토리를 생성합니다. Composer는 git을 사용하여 Laravel이 기능하기 위해 필요한 모든 패키지와 모듈을 다운로드하고 설치합니다.
아파치 구성하기
이제 Laravel을 설치했으므로 아파치 웹 서버를 구성하는 단계로 넘어갑니다.
다음 단계는 프로젝트 디렉토리에 적절한 권한을 부여하는 것입니다. 이를 위해 www-data 그룹에서 접근을 허용하고 storage 디렉토리에 쓰기 권한을 부여해야 합니다.
sudo chgrp -R www-data /var/www/html/your-project
sudo chmod -R 775 /var/www/html/your-project/storage이제 /etc/apache2/sites-available 디렉토리로 이동하여 다음 명령을 사용하여 Laravel 설치를 위한 구성 파일을 생성합니다.
cd /etc/apache2/sites-available
sudo nano laravel.conf이제 파일에 다음 내용을 추가하고 저장한 후 닫습니다. 파일 내에서 yourdomain.tld를 웹사이트의 도메인 이름으로 바꿉니다.
ServerName yourdomain.tld
ServerAdmin webmaster@localhost
DocumentRoot /var/www/html/your-project/public
AllowOverride All
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
이제 새로 생성한 .conf 파일을 활성화하고 기본 Apache 설치와 함께 제공되는 기본 .conf 파일을 비활성화해야 합니다. 또한 permalinks가 제대로 작동할 수 있도록 mod_rewrite를 활성화해야 합니다.
sudo a2dissite 000-default.conf
sudo a2ensite laravel.conf
sudo a2enmod rewrite
sudo service apache2 restart이제 Laravel 설치가 완료되었습니다. 웹 브라우저를 사용하여 서버의 IP 주소나 도메인 이름을 방문하세요 (제 경우 http://192.168.1.100). Laravel 기본 페이지가 표시됩니다.

이 튜토리얼의 가상 머신 다운로드
이 튜토리얼은 VMWare 및 Virtualbox와 호환되는 ovf/ova 형식의 사용 준비가 완료된 가상 머신 이미지로 제공됩니다. 가상 머신 이미지는 다음 로그인 세부정보를 사용합니다:
SSH / 셸 로그인
사용자 이름: administrator
비밀번호: howtoforge
루트 사용자로 전환하려면 다음을 실행하세요: sudo -s
비밀번호: howtoforge
VM의 IP는 192.168.1.100이며, /etc/network/interfaces 파일에서 변경할 수 있습니다. 가상 머신을 안전하게 보호하기 위해 위의 모든 비밀번호를 변경하세요.
새 게시물을 받은 편지함에서 받기
스팸은 없습니다. 언제든지 구독 해지 가능합니다.