Laravel 설치 · 2 min read · Jan 23, 2026

우분투에서 Nginx용 Laravel 설치하기

우리는 이미 지난 튜토리얼에서 Apache 기반 우분투 서버에 Laravel을 설치하는 방법에 대해 이야기했습니다. 이 튜토리얼에서는 Nginx 서버 설치에서 Laravel PHP 프레임워크를 설치하는 방법을 보여줍니다.

사전 요구 사항

항상 그렇듯이, 진행하기 전에 서버가 잘 업데이트되어 있는지 확인해야 합니다.

sudo apt-get update  
sudo apt-get upgrade

이 튜토리얼은 이미 우분투 기반 서버가 설정되어 있다고 가정합니다. 또한 Git이 설치되어 있는지 확인하십시오. 그렇지 않은 경우, 설치 방법에 대한 가이드를 참조할 수 있습니다.

Nginx 설치하기

Nginx 서버 설치는 간단하고 직관적입니다. 그러니 시작해봅시다.

sudo apt-get install nginx

PHP-FPM 설치하기

PHP는 Nginx와 Apache에서 작동하는 방식이 다릅니다. Nginx의 경우, PHP의 FastCGI 구현인 PHP-FPM(PHP-FastCGI Process Manager)이 필요합니다. 그러니 PHP를 설치합시다. Laravel이 작동하기 위해 PHP의 Mcrypt 확장도 필요합니다.

sudo apt-get install php5-fpm php5-cli php5-mcrypt

Laravel을 위한 Nginx 구성하기

진행하기 전에, 설치한 Nginx 서버의 기본 구성을 해봅시다. 먼저 Laravel이 설치될 디렉토리를 생성해야 합니다.

sudo mkdir -p /var/www/html/laravel

이제 Nginx에 이곳이 우리 사이트가 작동할 위치임을 알려야 합니다. 이를 위해 Nginx에 가상 호스트 항목을 생성해야 합니다. Nginx는 기본 구성을 /etc/nginx/sites-available/default라는 파일에 저장합니다. 이를 복사하여 우리만의 버전을 만들어 봅시다.

sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/laravel

구성 파일을 편집합시다.

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

다음과 같은 내용이 보일 것입니다.

server {
        listen 80 default_server;
        listen [::]:80 default_server ipv6only=on;

        root /usr/share/nginx/html;
        index index.html index.htm;

        server_name localhost;

        location / {
                try_files $uri $uri/ =404;
        }
}

가독성을 위해 주석을 제거했습니다. 루트 위치를 /var/www/html/laravel/public으로 변경해야 합니다. 또한 server_name 변수를 사용할 도메인 이름이나 서버의 IP 주소로 변경해야 합니다.

파일을 다음과 같이 편집하십시오.

server {
    listen 80 default_server;
    listen [::]:80 default_server ipv6only=on;

    root /var/www/html/laravel/public;
    index index.php index.html index.htm;

    server_name server_domain_or_IP;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        try_files $uri /index.php =404;
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass unix:/var/run/php5-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

편집 후 파일을 저장하십시오. 이제 이 구성 파일을 활성화해야 합니다. 현재는 기본 프로필만 활성화되어 있습니다. 이를 위해 /etc/nginx/sites-enabled 디렉토리에 laravel 파일에 대한 심볼릭 링크를 생성해야 합니다. 기본 프로필을 비활성화하여 Laravel 설치에 간섭하지 않도록 해야 합니다.

sudo ln -s /etc/nginx/sites-available/laravel /etc/nginx/sites-enabled/   
sudo rm /etc/nginx/sites-enabled/default

Nginx 서버의 구성은 완료되었습니다. 다음 단계는 PHP-FPM을 구성하는 것입니다.

PHP-FPM 구성하기

이 단계는 간단하며 PHP의 구성 파일에서 하나의 변수를 변경해야 합니다. php.ini를 열어봅시다.

sudo nano /etc/php5/fpm/php.ini

다음 텍스트를 찾아보십시오.

;cgi.fix_pathinfo=1

앞의 ;를 제거하여 변수를 주석 해제하고 값을 1로 변경하여 다음과 같이 보이게 합니다.

cgi.fix_pathinfo=0

이것은 PHP에게 원본 스크립트가 발견되지 않을 경우 유사한 이름의 스크립트를 실행하지 않도록 지시합니다. 이는 보안 관점에서 중요합니다.

마지막으로 이전에 설치한 mcrypt 확장을 활성화해야 합니다.

sudo php5enmod mcrypt

그게 전부입니다. 이제 PHP-FPM 서비스를 재시작하여 변경 사항을 로드하십시오.

sudo service restart php5-fpm

Composer 설치하기

Composer는 다양한 PHP 프레임워크와 라이브러리를 단일 명령으로 설치할 수 있게 해주는 의존성 관리 도구입니다. 수동으로 설치할 경우 별도로 설치해야 했던 다른 패키지와 의존성을 관리해줍니다. 많은 시간과 번거로움을 절약할 수 있습니다. 우리는 Composer를 사용하여 Laravel을 설치할 것입니다.

Composer를 다운로드합니다. 먼저 홈 디렉토리에 있는지 확인하십시오.

curl -sS https://getcomposer.org/installer | php

이 명령은 홈 디렉토리에 composer.phar 파일을 다운로드합니다. 이제 원하신다면 php composer.phar [command]와 같은 방식으로 여기서 실행할 수 있지만, Composer를 전역적으로 실행하려면 더 적절한 위치로 이동해야 합니다.

sudo mv composer.phar /usr/local/bin/composer

이제 어디서든 composer를 호출하여 직접 실행할 수 있습니다.

Laravel 설치하기

이제 Composer를 설치했으니 Laravel을 설치해야 합니다. 다음 명령으로 설치하십시오.

sudo composer create-project laravel/laravel /var/www/html/laravel --prefer-dist

이 명령은 최신 버전의 Laravel(현재 5.2)을 서버에 다운로드하고 설치합니다.

튜토리얼을 마치기 전에 몇몇 디렉토리에 적절한 권한을 부여해야 합니다.

sudo chgrp -R www-data /var/www/html/laravel  
sudo chmod -R 775 /var/www/html/laravel/storage

결론

그게 전부입니다. Laravel 설치가 완료되었습니다. 이제 브라우저에서 http://servername 또는 http://serverip를 실행하십시오. 성공적으로 설치되었다면 다음 화면이 표시되어야 합니다.

Share: X/Twitter LinkedIn

새 게시물을 받은 편지함에서 받기

스팸은 없습니다. 언제든지 구독 해지 가능합니다.