프레임워크 설치 · 2 min read · Sep 24, 2025

Debian 10에서 Nginx와 함께 Symfony 5 프레임워크 설치하는 방법

Symfony는 웹 애플리케이션, API, 마이크로서비스 및 웹 서비스를 구축하는 데 사용할 수 있는 무료 오픈 소스 고성능 PHP 프레임워크입니다. Symfony는 지루하고 광범위한 코딩 없이 웹 애플리케이션을 생성할 수 있게 해줍니다. Symfony는 프로젝트를 테스트, 디버그 및 문서화하는 데 도움이 되는 도구 세트를 제공합니다. Symfony는 모델-뷰-컨트롤러 디자인 패턴을 사용하며 웹 애플리케이션의 생성 및 유지 관리를 가속화하는 것을 목표로 합니다.

이 튜토리얼에서는 Debian 10에서 Nginx와 함께 Symfony 5를 설치하는 방법을 보여줍니다.

전제 조건

  • Debian 10이 실행되는 서버.
  • 서버에 루트 비밀번호가 설정되어 있어야 합니다.

시작하기

시작하기 전에 다음 명령어를 사용하여 서버를 최신 버전으로 업데이트하는 것이 좋습니다:

apt-get update -y  
apt-get upgrade -y

서버가 업데이트되면 변경 사항을 적용하기 위해 서버를 재시작합니다.

Nginx, MariaDB 및 PHP 설치

먼저, 서버에 Nginx, MariaDB, PHP 및 기타 필요한 라이브러리를 설치해야 합니다. 다음 명령어를 사용하여 모두 설치할 수 있습니다:

apt-get install nginx mariadb-server php php-fpm php-common php-mysql php-gmp php-curl php-intl php-mbstring php-xmlrpc php-gd php-bcmath php-soap php-ldap php-imap php-xml php-cli php-zip git unzip wget -y

모든 패키지가 설치되면 Nginx 및 MariaDB 서비스를 시작하고 시스템 재부팅 시 자동으로 시작되도록 설정합니다:

systemctl start nginx  
systemctl start mariadb  
systemctl enable nginx  
systemctl enable mariadb

작업이 완료되면 다음 단계로 진행할 수 있습니다.

Symfony 5 설치

먼저, 서버에 Composer를 설치해야 합니다. 다음 명령어를 사용하여 Composer 설치 스크립트를 다운로드할 수 있습니다:

wget https://getcomposer.org/installer

다음으로, 아래와 같이 설치 프로그램을 실행합니다:

php installer

Composer가 다운로드되면 다음과 같은 출력이 표시됩니다:

All settings correct for using Composer
Downloading...

Composer (version 1.9.1) successfully installed to: /root/composer.phar
Use it: php composer.phar

다음으로, Composer를 /usr/local/bin 디렉토리로 이동하고 실행 가능하게 만듭니다:

mv composer.phar /usr/local/bin/composer  
chmod +x /usr/local/bin/composer

이제 /var/www/html로 디렉토리를 변경하고 다음 명령어로 Symfony 5를 설치합니다:

cd /var/www/html  
composer create-project symfony/skeleton symfony5

다음으로, 아래와 같이 symfony5 디렉토리에 적절한 권한을 부여합니다:

chown -R www-data:www-data /var/www/html/symfony5  
chmod -R 755 /var/www/html/symfony5

Symfony 5를 위한 Nginx 구성

다음으로, Symfony 5를 위한 Nginx 가상 호스트 구성 파일을 생성해야 합니다. 다음 명령어로 생성할 수 있습니다:

nano /etc/nginx/sites-available/symfony.conf

다음 줄을 추가합니다:

server {
   server_name your-server-ip;
   root /var/www/html/symfony5/public;
   location / {
       try_files $uri /index.php$is_args$args;
   }
   location ~ ^/index\.php(/|$) {
       fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
       fastcgi_split_path_info ^(.+\.php)(/.*)$;
       include fastcgi_params;
       fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
       fastcgi_param DOCUMENT_ROOT $realpath_root;
       internal;
   }
   location ~ \.php$ {
       return 404;
   }
   error_log /var/log/nginx/symfony_error.log;
   access_log /var/log/nginx/symfony_access.log;
}

작업이 완료되면 파일을 저장하고 닫습니다. 그런 다음 다음 명령어로 Nginx 가상 호스트를 활성화합니다:

ln -s /etc/nginx/sites-available/symfony.conf /etc/nginx/sites-enabled/

다음으로, 다음 명령어로 Nginx에 구문 오류가 있는지 확인합니다:

ginx -t

다음과 같은 출력이 표시되어야 합니다:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

마지막으로, 변경 사항을 적용하기 위해 Nginx 서비스를 재시작합니다:

systemctl restart nginx

Symfony5 접근하기

이제 Symfony4가 설치되었으며, 웹 브라우저에서 http://your-server-ip URL을 방문하여 접근할 수 있습니다. Symfony 5 환영 페이지가 표시되어야 합니다:

Debian에서 Symfony 4

축하합니다! Debian 10 서버에 Symfony5를 성공적으로 설치했습니다. 이제 Symfony 5를 사용하여 PHP 애플리케이션을 호스팅할 수 있습니다.

Share: X/Twitter LinkedIn

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

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