프레임워크 설치 · 5 min read · Oct 22, 2025

우분투 22.04에 Apache 2와 함께 Laravel PHP 프레임워크 설치하는 방법

Laravel은 기업 웹 애플리케이션을 구축하기 위한 PHP 기반의 웹 애플리케이션 프레임워크입니다. 이는 모델-뷰-컨트롤러(MVC) 아키텍처를 따르는 무료 오픈 웹 프레임워크이며 Symfony를 기반으로 합니다. 우아한 구문을 제공하여 깔끔한 코드로 애플리케이션을 쉽게 읽고 이해할 수 있도록 만들어 줍니다.

Laravel은 기업 및 강력한 풀스택 웹 애플리케이션을 구축하기 위한 기업급 웹 프레임워크입니다. Laravel 애플리케이션은 개발 프로세스에서 프로덕션까지 번거로움 없이 빠르게 제공될 수 있습니다.

Laravel 웹 프레임워크를 React 또는 Vue와 같은 다른 프레임워크와 결합하면 아름답고 상호작용하는 프론트엔드를 만들 수 있습니다. 또한 MySQL, PostgreSQL, SQLite 및 SQL Server를 포함한 여러 데이터베이스를 지원합니다. Laravel은 안전한 인증을 위한 스캐폴딩도 제공합니다.

이 튜토리얼에서는 최신 우분투 22.04 LTS에 Laravel을 설치하는 방법을 배웁니다. 여기에는 Laravel 개발을 위한 LAMP 스택 설정 방법도 포함됩니다.

필수 조건

  • 우분투 22.04 머신. 이 예제에서는 우분투 서버를 사용합니다.
  • sudo 관리자 권한이 있는 비루트 사용자 또는 루트 사용자도 사용할 수 있습니다.

Apache 웹 서버 설치

첫 번째 단계에서는 Apache2 웹 서버를 우분투 시스템에 설치합니다. 이 예제에서는 Laravel 웹 프레임워크를 Apache 웹 서버와 함께 실행합니다.

이제 아래의 apt 명령어를 실행하여 우분투 저장소를 업데이트하고 새로 고칩니다.

sudo apt update

다음으로, 아래 명령어를 사용하여 Apache2 웹 서버 패키지를 설치합니다.

sudo apt install apache2

설치를 시작하려면 Y를 입력하고 ENTER를 누릅니다. Apache 웹 서버 설치가 시작됩니다.

install apache2

Apache2 설치가 완료되면 UFW 방화벽에 HTTP 및 HTTPS 서비스를 추가해야 합니다.

아래의 ufw 명령어를 실행하여 UFW 방화벽에 HTTP 및 HTTPS 서비스를 추가합니다.

sudo ufw allow "Apache Full"

마지막으로 웹 브라우저를 열고 주소 표시줄에 서버 IP 주소를 입력합니다(예: http://192.168.10.15). 이제 Apache2 웹 서버의 기본 index.html 페이지가 표시되어야 합니다.

apache2 index.html

PHP 8.1 설치

Apache 웹 서버 설치 후, 우분투 22.04 머신에 PHP를 설치하고 구성합니다. 기본 우분투 22.04 저장소는 PHP 패키지 v8.1을 제공하며, Laravel 웹 프레임워크에 잘 지원됩니다.

아래의 apt 명령어를 실행하여 Laravel 웹 프레임워크에 필요한 PHP 패키지를 설치합니다.

sudo apt install php php-curl php-bcmath php-json php-mbstring php-xml php-tokenizer php-zip

설치를 확인하려면 Y를 입력하고 ENTER를 눌러 계속 진행합니다. PHP 설치가 시작됩니다.

installing php 8.1

이제 PHP 설치가 완료되면 nano 편집기를 사용하여 php.ini 구성 파일을 편집합니다.

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

다음 옵션의 주석을 제거하여 PHP 확장 fileinfo, openssl, 및 mbstring을 활성화합니다.

extension=fileinfo  
extension=mbstring  
extension=openssl

작업이 완료되면 파일을 저장하고 닫습니다.

다음으로 Apache2 서비스를 재시작하여 PHP 구성에 대한 새로운 변경 사항을 적용합니다.

sudo systemctl restart apache2

마지막으로 아래 명령어를 실행하여 PHP 구성을 테스트하고 확인합니다.

우분투 머신에 설치된 PHP 버전을 확인합니다.

php --version

아래 스크린샷에서 PHP 8.1.2가 우분투 머신에 설치된 것을 볼 수 있습니다.

configure and check php

PHP 환경에서 활성화된 모든 확장을 확인합니다.

php -m

MariaDB 서버 설치

이제 Apache2 웹 서버와 PHP 패키지를 설치했습니다. 이제 우분투 22.04 머신에 MariaDB 데이터베이스 서버를 설치하고 구성합니다. 또한 Laravel 프로젝트를 위한 새로운 MariaDB 데이터베이스와 사용자를 생성합니다.

우분투 머신에 MariaDB 데이터베이스를 설치하려면 아래의 apt 명령어를 실행할 수 있습니다.

sudo apt install mariadb-server

설치를 시작하려면 Y를 입력하고 ENTER를 누릅니다.

install mariadb

MariaDB 설치가 완료되면 아래 명령어를 사용하여 루트 사용자로 MariaDB 셸에 로그인합니다.

sudo mysql -u root -p

이제 아래의 MariaDB 쿼리를 실행하여 Laravel 프로젝트를 위한 새로운 데이터베이스와 사용자를 생성합니다. 이 예제에서는 데이터베이스 laravelapp와 사용자 laravel, 비밀번호는 “ password “입니다.

CREATE DATABASE laravelapp;  
CREATE USER laravel@localhost IDENTIFIED BY 'password';  
GRANT ALL PRIVILEGES ON laravelapp.* TO laravel@localhost;  
FLUSH PRIVILEGES;

이제 “ EXIT “ 쿼리를 실행하여 MariaDB 셸에서 로그아웃합니다. 이제 MariaDB 데이터베이스 서버를 설치하고 Laravel 프로젝트를 위한 새로운 데이터베이스와 사용자를 생성했습니다.

create mariadb database

Composer 설치

이 섹션에서는 Composer를 설치합니다. Composer는 PHP 프로그래밍 언어를 위한 패키지 관리자이며, Python의 pip, Ruby의 gem, Node.js의 npm 또는 yarn과 유사합니다.

Laravel 웹 프레임워크는 여러 가지 방법으로 설치할 수 있습니다. 이 예제에서는 Composer를 사용하여 Laravel 웹 프레임워크를 설치합니다.

이제 아래 명령어를 실행하여 Composer 설치 프로그램을 다운로드합니다.

curl -sS https://getcomposer.org/installer -o composer-setup.php

이제 설치 프로그램 스크립트 “composer-setup.php”를 실행하여 Composer를 설치합니다. 이렇게 하면 Composer가 /usr/local/bin 디렉토리에 설치됩니다.

php composer-setup.php --install-dir=/usr/local/bin --filename=composer

아래는 Composer 설치 중의 스크린샷입니다.

install composer

설치가 완료되면 아래 명령어를 실행하여 Composer 설치를 확인하고 검증합니다.

Composer의 버전을 확인합니다.

sudo -u www-data composer --version

Composer의 도움말 내용을 표시합니다.

sudo -u www-data composer --help

check composer evrsion and help

이제 Laravel 설치를 시작할 준비가 되었습니다.

Laravel 설치 시작

Laravel 설치를 시작하기 전에 Laravel 프로젝트를 위한 새로운 디렉토리를 생성합시다.

이 예제에서는 PHP 패키지의 캐시를 저장하기 위한 디렉토리 “.cache”, Composer의 추가 구성을 저장하기 위한 디렉토리 “.config”, 그리고 Laravel 프로젝트 자체를 위한 디렉토리 “laravelapp”를 생성합니다. 이 모든 디렉토리는 “ /var/www “ 디렉토리 아래에 생성됩니다.

아래 명령어를 실행하여 Laravel 설치를 위한 새로운 디렉토리를 생성합니다.

mkdir -p /var/www/{.cache,.config,laravelapp}

이제 Laravel 및 Composer 디렉토리의 소유권을 사용자 및 그룹 www-data로 변경합니다.

sudo chown -R www-data:www-data /var/www/{.cache,.config,laravelapp}

다음으로 아래 명령어를 사용하여 /var/www/laravelapp 디렉토리로 이동합니다.

cd /var/www/laravelapp/

그런 다음 아래의 composer 명령어를 사용하여 Laravel 웹 프레임워크를 설치합니다. 명령어 끝의 점은 현재 작업 디렉토리 /var/www/laravelapp에 Laravel을 설치합니다.

sudo -u www-data composer create-project laravel/laravel .

아래는 Laravel 설치 과정의 스크린샷입니다.

install laravel

그리고 아래는 Laravel 설치가 완료된 후의 결과입니다.

laravel installation completed

설치가 완료된 후, nano 편집기를 사용하여 “.env” 파일을 편집합니다. 이 구성은 Laravel의 주요 환경 구성으로, 설치 URL, 데이터베이스 세부정보 등을 포함합니다.

nano .env

Laravel 설치를 위한 APP_URL 구성을 도메인으로 변경합니다. 이 예제에서는 laravel이 도메인 이름 laravelapp.howtoforge.local에서 실행됩니다.

APP_URL=http://laravelapp.howtoforge.local

이제 데이터베이스 세부정보를 데이터베이스 구성으로 변경합니다.

DB_CONNECTION=mysql  
DB_HOST=127.0.0.1  
DB_PORT=3306  
DB_DATABASE=laravelapp  
DB_USERNAME=laravel  
DB_PASSWORD=password

작업이 완료되면 파일을 저장하고 닫습니다.

이제 MariaDB 데이터베이스 서버와 함께 Laravel 웹 프레임워크 설치를 완료했습니다.

Apache 가상 호스트 설정

이제 Laravel 웹 프레임워크를 위한 Apache2 가상 호스트를 설정할 시간입니다. 이 예제에서는 Laravel 프로젝트가 로컬 도메인 laravelapp.howtoforge.local에서 실행됩니다.

nano 편집기를 사용하여 새로운 파일 “ /etc/apache2/sites-available/laravel.conf “를 생성합니다.

sudo nano /etc/apache2/sites-available/laravel.conf

파일에 다음 구성을 추가합니다. 도메인 이름을 사용하는 경우 도메인을 변경할 수 있습니다. 또한 Laravel 프로젝트의 Document root 경로를 변경해야 합니다.

  
    
    ServerAdmin [email protected]  
    ServerName laravelapp.howtoforge.local  
    DocumentRoot /var/www/laravelapp/public  
    
      
            Options FollowSymLinks  
            AllowOverride None  
      
      
            AllowOverride All  
      
    
    ErrorLog ${APACHE_LOG_DIR}/error.log  
    CustomLog ${APACHE_LOG_DIR}/access.log combined

작업이 완료되면 파일을 저장하고 닫습니다.

다음으로 아래 명령어를 사용하여 Apache2 모듈 재작성 및 가상 호스트 구성 laravel.conf를 활성화합니다.

sudo a2enmod rewrite  
sudo a2ensite laravel.conf

이제 Apache2 구성을 확인하고 오류가 없는지 확인합니다.

sudo apachectl configtest

configure apache2 laravel

이제 아래 명령어를 사용하여 Laravel 프로젝트에 대한 새로운 가상 호스트 구성을 적용하기 위해 Apache2 서비스를 재시작합니다.

sudo systemctl restart apache2

이제 Laravel에 대한 Apache 가상 호스트 구성을 완료했습니다.

당신의 머신에서 nano/vim 편집기를 사용하여 /etc/hosts 파일을 편집합니다.

sudo nano /etc/hosts

다음 구성을 추가합니다. 도메인 이름과 IP 주소를 서버의 세부정보로 변경해야 합니다.

192.168.10.15 laravelapp.howtoforge.local

작업이 완료되면 파일을 저장하고 닫습니다.

마지막으로 웹 브라우저로 돌아가서 주소 표시줄에 laravel 설치 URL(즉, http://laravelapp.howtoforge.local)을 입력합니다. 그러면 Laravel 웹 프레임워크의 기본 인덱스 페이지가 표시되어야 합니다. 또한 하단에서 방금 설치한 Laravel 버전과 현재 사용 중인 PHP 버전을 확인할 수 있습니다.

laravel index default

결론

축하합니다! 이제 우분투 22.04에 Laravel 웹 프레임워크를 성공적으로 설치했습니다. 또한 Laravel 웹 프레임워크를 위한 LAMP 스택의 기본 구성도 배웠습니다.

Share: X/Twitter LinkedIn
#프레임워크 설치

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

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