우분투 24.04에 Laravel PHP 프레임워크 설치하기

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

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

이 가이드는 우분투 24.04 서버에 Laravel 웹 프레임워크를 설치하는 방법을 알려줍니다. LAMP 스택(리눅스, 아파치, MySQL/MariaDB, PHP)과 Composer PHP 패키지 관리자를 사용하여 Laravel을 설치합니다.

전제 조건

이 가이드를 시작하기 전에 다음 사항을 확인하세요:

우분투 24.04 서버.
관리자 권한이 있는 비루트 사용자

LAMP 스택 및 Composer 설치

Laravel은 현대 웹 개발을 위한 인기 있는 PHP 웹 프레임워크입니다. 따라서 우분투 서버에 PHP 및 기타 종속성이 설치되어 있는지 확인해야 합니다. 이 섹션에서는 LAMP 스택(리눅스, 아파치, MySQL/MariaDB, PHP)과 Composer를 사용하여 Laravel을 설치합니다.

패키지를 설치하기 전에 다음 명령어를 실행하여 우분투 저장소를 업데이트합니다.

sudo apt update

update repo

이제 다음 명령어를 실행하여 LAMP 스택(리눅스, 아파치, MySQL/MariaDB, PHP), Composer 및 Git을 포함한 Laravel의 종속성을 설치합니다.

sudo apt install apache2 mariadb-server php php-curl php-bcmath php-json php-mysql php-mbstring php-xml php-tokenizer php-zip composer git

설치를 진행하려면 Y를 입력하세요.

설치가 완료되면 Apache와 MariaDB 서비스 상태를 확인하세요. 그런 다음 PHP와 Composer 버전을 확인하세요.

다음 명령어로 Apache 서비스 상태를 확인하세요. 우분투의 기본 Apache 서비스는 자동으로 활성화되고 실행되어야 합니다.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

출력:

check apache2

이제 아래 명령어를 사용하여 MariaDB 서비스를 확인하세요. MariaDB 서버는 우분투 시스템에서 활성화되고 실행되어야 합니다.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

출력:

check mariadb

마지막으로 아래 명령어를 사용하여 PHP와 Composer 버전을 확인하세요. 시스템에 PHP 8.3 및 Composer 2.7.1이 설치되어 있는 것을 볼 수 있습니다.

php -v  
sudo -u www-data composer -v

check php and composer

선택 사항: Node.js 및 NPM(Node.js 패키지 관리자) 설치

Node.js 및 NPM은 Blade와 JavaScript와 같은 템플릿 엔진을 사용하여 Laravel을 사용하는 경우 필요합니다. 이 섹션에서는 우분투 저장소를 통해 Node.js와 NPM(Node.js 패키지 관리자)을 모두 설치합니다.

우분투 시스템에 Node.js와 NPM을 설치하려면 다음을 실행하세요:

sudo apt install nodejs npm

설치를 확인하려면 Y를 입력하세요.

설치가 완료되면 아래 명령어를 입력하여 Node.js와 NPM 버전을 확인하세요.

node --version  
npm --version

다음 출력은 Node.js 18 및 NPM 9.5가 설치되어 있음을 보여줍니다.

PHP 구성

Laravel을 실행하려면 fileinfo, mbstring 및 openssl과 같은 일부 PHP 확장이 활성화되어 있는지 확인해야 합니다. 이제 ‘php.ini’ 파일을 수정하여 이러한 PHP 확장을 로드합니다.

nano 편집기를 사용하여 기본 PHP 구성 파일 ‘/etc/php/8.3/apache2/php.ini’를 편집합니다.

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

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

extension=fileinfo  
extension=mbstring  
extension=openssl

파일을 저장하고 편집기를 종료합니다.

이제 아래 명령어를 실행하여 Apache 서비스를 재시작하고 PHP 변경 사항을 적용합니다.

sudo systemctl restart apache2

다음으로 아래 명령어를 사용하여 PHP 확장 fileinfo, mbstring 및 openssl을 확인합니다. 이러한 확장이 활성화되어 있으면 각 확장 이름이 표시됩니다.

sudo php -m | grep 'fileinfo\|mbstring\|openssl'

setup php

또한 PHPINFO를 통해 활성화된 PHP 확장 목록을 확인할 수 있습니다. 다음 명령어로 새로운 PHPINFO 파일을 생성합니다.

echo "" > /var/www/html/info.php

그런 다음 http://192.168.5.30/info.php를 방문하세요. 확장 fileinfo, mbstring 및 openssl이 활성화되어 있는지 확인하세요.

phpinfo

MariaDB 서버 구성

PHP 구성이 완료되면 MariaDB 서버를 보호하고 Laravel을 위한 새로운 데이터베이스와 사용자를 생성해야 합니다.

아래 ‘mariadb-secure-installation’ 명령어를 실행하여 MariaDB 서버를 보호하세요. 이제 MariaDB 서버 구성에 대한 프롬프트가 표시됩니다.

sudo mariadb-secure-installation

프롬프트가 표시되면 Y를 입력하여 새 구성을 적용하거나 N을 입력하여 거부하세요.

기본 MariaDB 설치는 비밀번호 없이 제공됩니다. 비밀번호를 요청받으면 ENTER를 누르세요.
이제 Y를 입력하여 MariaDB 루트 비밀번호를 설정합니다. 그런 다음 MariaDB의 새 비밀번호를 입력하고 비밀번호를 반복합니다.
MariaDB 설치에서 익명 사용자를 제거하려면 Y를 입력하세요.
MariaDB 루트 사용자의 원격 로그인을 비활성화하라는 프롬프트가 표시되면 다시 Y를 입력하세요.
MariaDB의 기본 데이터베이스 테스트를 제거하려면 Y를 입력하세요.
마지막으로 Y를 입력하여 테이블 권한을 다시 로드하고 새 변경 사항을 적용하세요.

MariaDB 서버를 보호한 후 Laravel 프로젝트를 위한 새로운 데이터베이스와 사용자를 생성해야 합니다.

아래 명령어를 사용하여 MariaDB 서버에 로그인하세요. 프롬프트가 표시되면 MariaDB 루트 비밀번호를 입력하세요.

sudo mariadb -u root -p

이제 다음 쿼리를 실행하여 새로운 데이터베이스와 사용자 ‘laravelapp‘을 생성하고 비밀번호 ‘password‘를 설정합니다.

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

creating database

다음으로 아래 쿼리를 실행하여 사용자 ‘laravelapp‘의 권한을 확인하세요. 이렇게 하면 사용자가 Laravel 데이터베이스 ‘laravelapp‘에 접근할 수 있습니다.

SHOW GRANTS FOR laravelapp@localhost;

마지막으로 quit를 입력하여 MariaDB 서버에서 로그아웃하세요.

show privileges for user

Composer를 통한 Laravel 설치

이제 PHP를 구성하고 MySQL/MariaDB 데이터베이스와 사용자를 생성했으므로 Laravel을 설치할 수 있습니다. 이 섹션에서는 프로젝트 디렉토리를 설정하고 Composer를 통해 Laravel을 설치하며 MySQL/MariaDB 데이터베이스와 통합합니다.

먼저 아래 명령어를 실행하여 /var/www/.cache (Composer 캐시용), /var/www/.config (추가 Composer 구성용), /var/www/laravelapp (Laravel 프로젝트용) 디렉토리를 생성합니다.

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

이제 /var/www/.cache, /var/www/.config 및 /var/www/laravelapp 디렉토리의 소유권을 사용자 ‘www-data‘로 변경합니다.

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

다음으로 /var/www/laravelapp 디렉토리로 이동하여 아래 Composer 명령어로 Laravel을 설치합니다.

cd /var/www/laravelapp/  
sudo -u www-data composer create-project laravel/laravel .

Laravel 설치가 다음과 같이 시작되어야 합니다:

install Laravel via composer

이제 아래 nano 편집기 명령어를 사용하여 ‘.env’ 파일을 엽니다.

nano .env

기본 ‘ APP_URL ‘을 로컬 도메인 이름으로 변경합니다. 이 예제에서는 Laravel이 ‘laravelapp.local’ 도메인에서 실행됩니다.

APP_URL=http://laravelapp.local

기본 ‘ DB_CONNECTION ‘을 ‘ mysql ‘로 변경하고 주석을 제거한 후 데이터베이스 세부 정보를 귀하의 정보로 변경합니다.

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

파일을 저장하고 종료합니다.

마지막으로 아래 명령어를 실행하여 Laravel 프로젝트의 데이터베이스를 마이그레이션합니다.

sudo -u www-data php artisan migrate

Laravel 데이터베이스 마이그레이션의 출력:

Migrate database

Laravel을 위한 가상 호스트 설정

이 섹션에서는 Laravel을 위한 가상 호스트 파일을 설정합니다. Laravel 개발을 위한 로컬 도메인 이름이 준비되어 있는지 확인하세요.

가상 호스트를 생성하기 전에 아래 명령어로 Apache의 ‘rewrite‘ 모듈을 활성화합니다.

sudo a2enmod rewrite

nano 편집기를 사용하여 새로운 가상 호스트 구성 ‘/etc/apache2/sites-available/laravelapp.conf‘를 생성합니다.

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

다음 구성을 추가하고 ServerName 옵션을 Laravel 도메인 이름으로 변경합니다. 예를 들어 ‘laravelapp.local‘로 변경합니다.

  
  
 ServerAdmin [email protected]  
 ServerName laravelapp.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

파일을 저장하고 편집기를 종료합니다.

이제 아래 명령어를 실행하여 ‘laravelapp.conf‘ 가상 호스트를 활성화하고 Apache 구문을 확인합니다. 오류가 없으면 ‘Syntax OK‘라는 출력을 볼 수 있습니다.

sudo a2ensite laravelapp.conf  
sudo apachectl configtest

Apache 서비스를 재시작하여 새로운 Laravel 가상 호스트 파일을 적용합니다. Apache가 재시작된 후 Laravel 설치가 준비됩니다.

sudo systemctl restart apache2

setup apache vhost

Laravel 프로젝트 접근

이 시점에서 ‘hosts’ 파일을 통해 Laravel 설치에 접근할 준비가 되었습니다.

리눅스 또는 MacOS 사용자는 루트 권한으로 ‘/etc/hosts‘ 파일을 수정합니다. 윈도우 사용자는 관리자 권한으로 ‘C:\Windows\System32\drivers\etc\hosts‘ 파일을 엽니다.

우분투 서버 IP 주소 뒤에 Laravel 도메인 이름을 추가합니다:

192.168.5.30 laravelapp.local

파일을 저장하고 종료합니다.

이제 웹 브라우저로 http://laravelapp.local/를 방문하세요. Laravel 설치가 성공적이라면 다음 페이지를 볼 수 있습니다:

Laravel app

결론

축하합니다! 우분투 24.04에 Laravel 설치를 완료했습니다. LAMP 스택(리눅스, 아파치, MySQL/MariaDB, PHP)에서 Laravel이 실행되고 있으며, 프로젝트 생성을 위한 기본 Composer 명령어를 배웠습니다.