Laravel 설치 · 5 min read · Sep 23, 2025

Alma Linux 9에 Laravel PHP 프레임워크 설치하는 방법

Laravel은 기업 및 강력한 풀스택 웹 애플리케이션을 구축하는 데 사용되는 PHP 기반의 웹 애플리케이션 프레임워크입니다. 이 프레임워크는 모델-뷰-컨트롤러(MVC) 아키텍처를 따르며 Symfony를 기반으로 합니다. Laravel은 MySQL, PostgreSQL, SQLite 및 SQL Server를 포함한 여러 데이터베이스를 지원합니다. 또한 Laravel은 안전한 인증을 위한 스캐폴딩을 제공합니다.

이 튜토리얼에서는 Alma Linux 9 서버에 Laravel을 설치하는 방법을 보여줍니다. LAMP 스택(Linux, Apache/Httpd, MariaDB 및 PHP)과 Composer를 사용하여 Laravel 설치를 안내합니다.

전제 조건

앞으로 나아가기 전에 다음 사항을 확인하십시오:

  • Alma Linux 9 서버.
  • 관리자 권한이 있는 비루트 사용자.
  • 로컬 도메인 이름.
  • 허용 모드의 SELinux.

LAMP 스택 및 Composer 설치

Laravel은 웹 애플리케이션을 구축하기 위한 가장 인기 있는 PHP 웹 프레임워크 중 하나입니다. Laravel을 설치하려면 LAMP 스택(Apache/Httpd, MariaDB 및 PHP)과 Composer를 포함한 종속성을 설치해야 합니다. 현재 Laravel은 PHP 8.3을 요구합니다. PHP 8.3은 서드파티 리포지토리를 통해 설치해야 합니다.

먼저, 아래 명령어를 사용하여 Alma Linux 서버에 서드파티 리포지토리 EPEL 및 Remi를 추가합니다. EPEL 리포지토리는 Composer와 같은 패키지를 설치하는 데 사용되며, Remi 리포지토리는 Laravel을 위한 여러 PHP 버전을 제공합니다.

sudo dnf install epel-release dnf-utils http://rpms.remirepo.net/enterprise/remi-release-9.rpm

add repo

이제 아래 명령어를 사용하여 Remi를 통해 PHP 8.3 리포지토리를 활성화합니다.

sudo dnf reset php -y  
sudo dnf module enable php:remi-8.3 -y

다음으로, 아래 명령어로 LAMP 스택(Apache/Httpd, MariaDB 및 PHP)과 Composer 패키지를 설치합니다. 설치를 확인하려면 y를 입력하십시오.

sudo dnf install httpd mariadb-server composer php php-curl php-bcmath php-json php-mbstring php-xml php-tokenizer php-zip

install deps

설치가 완료되면 아래 명령어로 httpd 서비스를 시작하고 활성화합니다.

sudo systemctl start httpd  
sudo systemctl enable httpd

그런 다음 아래 명령어로 MariaDB 서버를 시작하고 활성화합니다.

sudo systemctl start mariadb  
sudo systemctl enable mariadb

이제 아래 명령어를 사용하여 PHP 및 Composer 버전을 확인합니다. PHP 8.3 및 Composer 2.7.1이 설치되어 있어야 합니다.

php -v  
sudo -u apache composer -v

check php and composer

마지막으로, 아래 명령어를 실행하여 PHP 모듈을 확인합니다. fileinfo, mbstring 및 openssl이 활성화되어 있는지 확인하십시오.

php -m

MariaDB 구성

PHP가 구성되면 MariaDB 서버를 안전하게 설정하고 Laravel을 위한 새로운 데이터베이스와 사용자를 생성합니다. MariaDB 서버는 MariaDB 서버를 안전하게 설정하기 위한 MariaDB-secure-installation 유틸리티와 명령줄을 통해 MariaDB 서버에 연결하기 위한 MariaDB 클라이언트를 제공합니다.

MariaDB 서버를 안전하게 설정하려면 아래 명령어를 실행하고 MariaDB 서버 구성에 대한 몇 가지 질문을 받게 됩니다. Y 또는 N을 입력하여 새로운 MariaDB 변경 사항을 적용할 것인지 동의하거나 거부하십시오.

sudo mariadb-secure-installation

아래는 질문을 받을 MariaDB 서버 구성의 일부입니다:

  • unix_socket 인증으로 전환하시겠습니까?. n을 입력하고 ENTER를 누르십시오. 기본 MariaDB 루트 사용자는 이미 보호되어 있습니다. 선택적으로 y를 입력하여 활성화할 수 있습니다.
  • 루트 비밀번호를 변경하시겠습니까?. y를 입력하여 확인하고 새로운 MariaDB 루트 비밀번호를 설정하십시오.
  • 익명 사용자를 제거하시겠습니까?. y를 입력하여 확인하십시오.
  • 원격에서 루트 로그인을 허용하지 않으시겠습니까? y를 입력하여 확인하십시오. MariaDB 루트 사용자로 사용할 경우 로컬 연결만 허용됩니다.
  • 테스트 데이터베이스 및 이에 대한 접근을 제거하시겠습니까?. y를 입력하여 확인하고 기본 데이터베이스 ‘test’를 제거하십시오.
  • 마지막으로, y를 입력하여 MariaDB 서버의 모든 테이블 권한을 다시 로드하고 새로운 변경 사항을 적용하십시오.

MariaDB가 안전하게 설정된 후, mariadb 클라이언트를 통해 Laravel을 위한 새로운 데이터베이스와 사용자를 생성합니다.

아래 mariadb 클라이언트 명령어로 MariaDB 서버에 로그인합니다. 프롬프트가 나타나면 MariaDB 루트 비밀번호를 입력하십시오.

sudo mariadb -u root -p

이제 다음 쿼리를 실행하여 Laravel을 위한 새로운 데이터베이스와 사용자를 생성합니다. 이 예제에서는 새로운 데이터베이스 laravelapp과 사용자 laravel을 생성하며, 비밀번호는 p4ssw0rd입니다. 아래 데이터베이스 및 사용자 세부정보를 귀하의 정보로 조정하십시오.

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

create database

다음으로, 아래 쿼리를 실행하여 사용자 laravel의 권한을 확인합니다. 사용자 laravel이 데이터베이스 laravelapp에 접근할 수 있는지 확인하십시오.

SHOW PRIVILEGES FOR laravel@localhost;

마지막으로, quit을 입력하여 MariaDB 서버에서 종료합니다.

show privileges

Laravel 프로젝트 생성

이제 PHP와 MariaDB를 모두 구성했으므로, 시스템에 Laravel을 다운로드하고 설치합시다. 프로젝트 디렉토리를 생성하고 설정한 다음, Composer를 통해 Laravel 프로젝트를 다운로드하고 설치합니다.

Laravel 프로젝트를 위한 새로운 디렉토리 /var/www/laravelapp과 Composer 캐시 및 구성을 저장하기 위한 추가 디렉토리 .cache 및 .config를 생성합니다. 그런 다음 이러한 디렉토리의 소유권을 사용자 apache로 변경합니다.

mkdir -p /var/www/laravelapp /usr/share/httpd/.composer/{.cache,.config}  
sudo chown -R apache:apache /var/www/laravelapp /usr/share/httpd/.composer

/var/www/laravelapp 디렉토리로 이동한 후 아래 Composer 명령어를 실행하여 Laravel을 다운로드하고 설치합니다.

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

다운로드 과정은 다음과 같아야 합니다:

install Laravel

Laravel이 다운로드되면 아래 nano 편집기 명령어를 사용하여 .env 파일을 엽니다.

nano .env

APP_URL을 로컬 도메인 이름으로 변경한 다음, 데이터베이스 세부정보를 MariaDB 데이터베이스 정보로 변경합니다.

APP_URL=http://dev.hwdomain.local  
DB_CONNECTION=mysql  
DB_HOST=127.0.0.1  
DB_PORT=3306  
DB_DATABASE=laravelapp  
DB_USERNAME=laravel  
DB_PASSWORD=password

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

이제 아래 명령어를 실행하여 데이터베이스를 마이그레이션하고 테이블에 새로운 샘플 데이터를 채웁니다.

sudo -u apache php artisan migrate  
sudo -u apache php artisan db:seed

migrate database

Httpd 가상 호스트 설정

Laravel을 설치한 후, Laravel이 사용할 새로운 Httpd 가상 호스트 구성을 생성합니다. 이를 위해 로컬 도메인 이름이나 원하는 임의의 도메인을 준비하십시오. 이 도메인은 나중에 구성할 수 있습니다.

아래 nano 편집기 명령어를 사용하여 새로운 httpd 가상 호스트 구성 /etc/httpd/conf.d/laravel.conf를 생성합니다.

sudo nano /etc/httpd/conf.d/laravel.conf

다음 구성을 삽입하고 ServerName 옵션을 Laravel 도메인 이름으로 변경하십시오.

  
  
  ServerAdmin [email protected]  
  ServerName dev.hwdomain.local  
  DocumentRoot /var/www/laravelapp/public  
  
    
    Options FollowSymLinks  
    AllowOverride None  
    
    
    AllowOverride All  
    
  
  ErrorLog /var/log/httpd/laravel-error.log  
  CustomLog /var/log/httpd/laravel-access.log combined

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

이제 아래 명령어를 실행하여 httpd 구성을 확인합니다. 올바른 httpd 구문이 있는 경우 Syntax OK라는 출력을 받아야 합니다.

sudo apachectl configtest

마지막으로, httpd 서비스를 재시작하여 Laravel을 위한 새로운 가상 호스트 구성을 적용합니다.

sudo systemctl restart httpd

setup vhost

Firewalld 설정

Laravel 설치에 접근하기 전에 시스템에서 HTTP 및 HTTPS 포트를 열어야 하며, 이는 Firewalld를 통해 수행할 수 있습니다.

아래 명령어를 사용하여 Alma Linux 서버에서 HTTP 및 HTTPS 트래픽을 모두 열어줍니다.

sudo firewall-cmd --add-service=http --permanent  
sudo firewall-cmd --add-service=https --permanent

이제 변경 사항을 적용하기 위해 firewalld를 다시 로드합니다.

sudo firewall-cmd --reload

마지막으로, 아래 명령어를 사용하여 firewalld 목록 규칙을 확인합니다. HTTP 및 HTTPS 서비스가 firewalld에 추가된 것을 볼 수 있습니다.

sudo firewall-cmd --list-all

setup firewalld

로컬 컴퓨터에서 Laravel 접근하기

Laravel 설치를 위한 로컬 도메인 이름을 설정하려면 다음을 사용하십시오:

  • Windows 사용자의 경우, C:\Windows\System32\drivers\etc\hosts 파일을 관리자 권한으로 수정하십시오.
  • Linux 및 Mac 사용자의 경우, /etc/hosts 파일을 루트 권한으로 엽니다.

아래 구성을 삽입하고 IP 주소와 도메인 이름을 귀하의 정보로 변경하십시오.

192.168.5.60 dev.hwdomain.local

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

이제 웹 브라우저를 열고 Laravel 설치 http://dev.hwdomain.local/에 방문하십시오. 설치가 성공적이라면 다음 Laravel 인덱스 페이지를 볼 수 있어야 합니다.

laravel

결론

축하합니다! Alma Linux 9에 LAMP 스택(Linux, Apache/Httpd, MariaDB 및 PHP)과 Composer를 사용하여 Laravel 설치를 완료했습니다. 또한 HTTP 및 HTTPS 포트를 열기 위해 firewalld를 구성하고, /etc/hosts 파일 또는 C:\Windows\System32\drivers\etc\hosts 파일을 통해 Laravel 개발을 위한 로컬 도메인 이름을 구성했습니다.

Share: X/Twitter LinkedIn
#Laravel 설치

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

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