개요 및 설치방법
이 장에서는 라라벨을 설치하는 방법에 대해 기술합니다.
설치방법은 Laravel Installer 를 이용하는 방법과, Composer 를 통한 방법 2가지가 있습니다.
Laravel Installer 또한 Composer 를 통한 사전 설치가 되어있어야 하며, Installer 가 없더라도 Composer 를 통한 직접 설치가 가능하기 때문에 이 장에서는 Composer 로 직접 설치하는 방법에 대해 기술합니다.
참고 : https://laravel.kr/docs/8.x/installation
라라벨 8.x - 설치하기
라라벨 한글 메뉴얼 8.x - 설치하기
laravel.kr
설치 환경
- Laravel v8.72.0 (PHP v7.4.25)
- Nginx (with php-fpm upstream)
- PHP Composer
- Docker 기반의 컨테이너 환경
※ 1~3 은 필수항목이나 Laravel 및 PHP의 버전은 선택적으로 사용가능하며, 4번 항목은 선택사항으로 반드시 컨테이너 환경이 아니어도 무방합니다.
설치하기
# Project 디렉토리 : /var/www
# 설치경로 : /var/www/tailerbox
# 설치명령 : composer create-project --prefer-dist laravel/laravel {your-project-name}
# 옵션 : --prefer-dist >> 안정화 버전 배포판을 사용
root@fbb55136d2a1:/var/www# composer create-project --prefer-dist laravel/laravel tailerbox
Creating a "laravel/laravel" project at "./tailerbox"
Installing laravel/laravel (v8.6.7)
- Downloading laravel/laravel (v8.6.7)
- Installing laravel/laravel (v8.6.7): Extracting archive
Created project in /var/www/tailerbox
> @php -r "file_exists('.env') || copy('.env.example', '.env');"
Loading composer repositories with package information
Updating dependencies
Lock file operations: 111 installs, 0 updates, 0 removals
- Locking asm89/stack-cors (v2.0.3)
- Locking brick/math (0.9.3)
- Locking dflydev/dot-access-data (v3.0.1)
- Locking doctrine/inflector (2.0.4)
- Locking doctrine/instantiator (1.4.0)
- Locking doctrine/lexer (1.2.1)
- Locking dragonmantank/cron-expression (v3.1.0)
- Locking egulias/email-validator (2.1.25)
- Locking facade/flare-client-php (1.9.1)
- Locking facade/ignition (2.16.1)
- Locking facade/ignition-contracts (1.0.2)
- Locking fakerphp/faker (v1.16.0)
- Locking filp/whoops (2.14.4)
- Locking fruitcake/laravel-cors (v2.0.4)
- Locking graham-campbell/result-type (v1.0.3)
- Locking guzzlehttp/guzzle (7.4.0)
- Locking guzzlehttp/promises (1.5.1)
- Locking guzzlehttp/psr7 (2.1.0)
- Locking hamcrest/hamcrest-php (v2.0.1)
- Locking laravel/framework (v8.72.0)
- Locking laravel/sail (v1.12.5)
- Locking laravel/sanctum (v2.12.2)
- Locking laravel/serializable-closure (v1.0.4)
- Locking laravel/tinker (v2.6.2)
- Locking league/commonmark (2.0.2)
- Locking league/config (v1.1.1)
- Locking league/flysystem (1.1.5)
- Locking league/mime-type-detection (1.8.0)
- Locking mockery/mockery (1.4.4)
- Locking monolog/monolog (2.3.5)
- Locking myclabs/deep-copy (1.10.2)
- Locking nesbot/carbon (2.54.0)
- Locking nette/schema (v1.2.2)
- Locking nette/utils (v3.2.5)
- Locking nikic/php-parser (v4.13.1)
- Locking nunomaduro/collision (v5.10.0)
- Locking opis/closure (3.6.2)
- Locking phar-io/manifest (2.0.3)
- Locking phar-io/version (3.1.0)
- Locking phpdocumentor/reflection-common (2.2.0)
- Locking phpdocumentor/reflection-docblock (5.3.0)
- Locking phpdocumentor/type-resolver (1.5.1)
- Locking phpoption/phpoption (1.8.0)
- Locking phpspec/prophecy (1.14.0)
- Locking phpunit/php-code-coverage (9.2.8)
- Locking phpunit/php-file-iterator (3.0.5)
- Locking phpunit/php-invoker (3.1.1)
- Locking phpunit/php-text-template (2.0.4)
- Locking phpunit/php-timer (5.0.3)
- Locking phpunit/phpunit (9.5.10)
- Locking psr/container (1.1.2)
- Locking psr/event-dispatcher (1.0.0)
- Locking psr/http-client (1.0.1)
- Locking psr/http-factory (1.0.1)
- Locking psr/http-message (1.0.1)
- Locking psr/log (1.1.4)
- Locking psr/simple-cache (1.0.1)
- Locking psy/psysh (v0.10.9)
- Locking ralouphie/getallheaders (3.0.3)
- Locking ramsey/collection (1.2.2)
- Locking ramsey/uuid (4.2.3)
- Locking sebastian/cli-parser (1.0.1)
- Locking sebastian/code-unit (1.0.8)
- Locking sebastian/code-unit-reverse-lookup (2.0.3)
- Locking sebastian/comparator (4.0.6)
- Locking sebastian/complexity (2.0.2)
- Locking sebastian/diff (4.0.4)
- Locking sebastian/environment (5.1.3)
- Locking sebastian/exporter (4.0.4)
- Locking sebastian/global-state (5.0.3)
- Locking sebastian/lines-of-code (1.0.3)
- Locking sebastian/object-enumerator (4.0.4)
- Locking sebastian/object-reflector (2.0.4)
- Locking sebastian/recursion-context (4.0.4)
- Locking sebastian/resource-operations (3.0.3)
- Locking sebastian/type (2.3.4)
- Locking sebastian/version (3.0.2)
- Locking swiftmailer/swiftmailer (v6.3.0)
- Locking symfony/console (v5.3.10)
- Locking symfony/css-selector (v5.3.4)
- Locking symfony/deprecation-contracts (v2.4.0)
- Locking symfony/error-handler (v5.3.7)
- Locking symfony/event-dispatcher (v5.3.7)
- Locking symfony/event-dispatcher-contracts (v2.4.0)
- Locking symfony/finder (v5.3.7)
- Locking symfony/http-client-contracts (v2.4.0)
- Locking symfony/http-foundation (v5.3.10)
- Locking symfony/http-kernel (v5.3.10)
- Locking symfony/mime (v5.3.8)
- Locking symfony/polyfill-ctype (v1.23.0)
- Locking symfony/polyfill-iconv (v1.23.0)
- Locking symfony/polyfill-intl-grapheme (v1.23.1)
- Locking symfony/polyfill-intl-idn (v1.23.0)
- Locking symfony/polyfill-intl-normalizer (v1.23.0)
- Locking symfony/polyfill-mbstring (v1.23.1)
- Locking symfony/polyfill-php72 (v1.23.0)
- Locking symfony/polyfill-php73 (v1.23.0)
- Locking symfony/polyfill-php80 (v1.23.1)
- Locking symfony/polyfill-php81 (v1.23.0)
- Locking symfony/process (v5.3.7)
- Locking symfony/routing (v5.3.7)
- Locking symfony/service-contracts (v2.4.0)
- Locking symfony/string (v5.3.10)
- Locking symfony/translation (v5.3.10)
- Locking symfony/translation-contracts (v2.4.0)
- Locking symfony/var-dumper (v5.3.10)
- Locking theseer/tokenizer (1.2.1)
- Locking tijsverkoyen/css-to-inline-styles (2.2.3)
- Locking vlucas/phpdotenv (v5.4.0)
- Locking voku/portable-ascii (1.5.6)
- Locking webmozart/assert (1.10.0)
Writing lock file
Installing dependencies from lock file (including require-dev)
Package operations: 111 installs, 0 updates, 0 removals
- Downloading laravel/serializable-closure (v1.0.4)
- Downloading laravel/framework (v8.72.0)
- Downloading facade/ignition (2.16.1)
- Downloading laravel/sail (v1.12.5)
- Downloading laravel/sanctum (v2.12.2)
- Installing doctrine/inflector (2.0.4): Extracting archive
- Installing doctrine/lexer (1.2.1): Extracting archive
- Installing symfony/polyfill-ctype (v1.23.0): Extracting archive
- Installing webmozart/assert (1.10.0): Extracting archive
- Installing dragonmantank/cron-expression (v3.1.0): Extracting archive
- Installing symfony/polyfill-php80 (v1.23.1): Extracting archive
- Installing symfony/polyfill-mbstring (v1.23.1): Extracting archive
- Installing symfony/var-dumper (v5.3.10): Extracting archive
- Installing symfony/polyfill-intl-normalizer (v1.23.0): Extracting archive
- Installing symfony/polyfill-intl-grapheme (v1.23.1): Extracting archive
- Installing symfony/string (v5.3.10): Extracting archive
- Installing psr/container (1.1.2): Extracting archive
- Installing symfony/service-contracts (v2.4.0): Extracting archive
- Installing symfony/polyfill-php73 (v1.23.0): Extracting archive
- Installing symfony/deprecation-contracts (v2.4.0): Extracting archive
- Installing symfony/console (v5.3.10): Extracting archive
- Installing psr/log (1.1.4): Extracting archive
- Installing monolog/monolog (2.3.5): Extracting archive
- Installing voku/portable-ascii (1.5.6): Extracting archive
- Installing phpoption/phpoption (1.8.0): Extracting archive
- Installing graham-campbell/result-type (v1.0.3): Extracting archive
- Installing vlucas/phpdotenv (v5.4.0): Extracting archive
- Installing symfony/css-selector (v5.3.4): Extracting archive
- Installing tijsverkoyen/css-to-inline-styles (2.2.3): Extracting archive
- Installing symfony/routing (v5.3.7): Extracting archive
- Installing symfony/process (v5.3.7): Extracting archive
- Installing symfony/polyfill-php72 (v1.23.0): Extracting archive
- Installing symfony/polyfill-intl-idn (v1.23.0): Extracting archive
- Installing symfony/mime (v5.3.8): Extracting archive
- Installing symfony/http-foundation (v5.3.10): Extracting archive
- Installing symfony/http-client-contracts (v2.4.0): Extracting archive
- Installing psr/event-dispatcher (1.0.0): Extracting archive
- Installing symfony/event-dispatcher-contracts (v2.4.0): Extracting archive
- Installing symfony/event-dispatcher (v5.3.7): Extracting archive
- Installing symfony/error-handler (v5.3.7): Extracting archive
- Installing symfony/http-kernel (v5.3.10): Extracting archive
- Installing symfony/finder (v5.3.7): Extracting archive
- Installing symfony/polyfill-iconv (v1.23.0): Extracting archive
- Installing egulias/email-validator (2.1.25): Extracting archive
- Installing swiftmailer/swiftmailer (v6.3.0): Extracting archive
- Installing symfony/polyfill-php81 (v1.23.0): Extracting archive
- Installing ramsey/collection (1.2.2): Extracting archive
- Installing brick/math (0.9.3): Extracting archive
- Installing ramsey/uuid (4.2.3): Extracting archive
- Installing psr/simple-cache (1.0.1): Extracting archive
- Installing opis/closure (3.6.2): Extracting archive
- Installing symfony/translation-contracts (v2.4.0): Extracting archive
- Installing symfony/translation (v5.3.10): Extracting archive
- Installing nesbot/carbon (2.54.0): Extracting archive
- Installing league/mime-type-detection (1.8.0): Extracting archive
- Installing league/flysystem (1.1.5): Extracting archive
- Installing nette/utils (v3.2.5): Extracting archive
- Installing nette/schema (v1.2.2): Extracting archive
- Installing dflydev/dot-access-data (v3.0.1): Extracting archive
- Installing league/config (v1.1.1): Extracting archive
- Installing league/commonmark (2.0.2): Extracting archive
- Installing laravel/serializable-closure (v1.0.4): Extracting archive
- Installing laravel/framework (v8.72.0): Extracting archive
- Installing facade/ignition-contracts (1.0.2): Extracting archive
- Installing guzzlehttp/guzzle (7.4.0): Extracting archive
- Installing laravel/sail (v1.12.5): Extracting archive
- Installing laravel/sanctum (v2.12.2): Extracting archive
- Installing nikic/php-parser (v4.13.1): Extracting archive
- Installing psy/psysh (v0.10.9): Extracting archive
- Installing laravel/tinker (v2.6.2): Extracting archive
- Installing hamcrest/hamcrest-php (v2.0.1): Extracting archive
- Installing mockery/mockery (1.4.4): Extracting archive
- Installing filp/whoops (2.14.4): Extracting archive
- Installing nunomaduro/collision (v5.10.0): Extracting archive
- Installing phpdocumentor/reflection-common (2.2.0): Extracting archive
- Installing phpdocumentor/type-resolver (1.5.1): Extracting archive
- Installing phpdocumentor/reflection-docblock (5.3.0): Extracting archive
- Installing sebastian/version (3.0.2): Extracting archive
- Installing sebastian/type (2.3.4): Extracting archive
- Installing sebastian/resource-operations (3.0.3): Extracting archive
- Installing sebastian/recursion-context (4.0.4): Extracting archive
- Installing sebastian/object-reflector (2.0.4): Extracting archive
- Installing sebastian/object-enumerator (4.0.4): Extracting archive
- Installing sebastian/global-state (5.0.3): Extracting archive
- Installing sebastian/exporter (4.0.4): Extracting archive
- Installing sebastian/environment (5.1.3): Extracting archive
- Installing sebastian/diff (4.0.4): Extracting archive
- Installing sebastian/comparator (4.0.6): Extracting archive
- Installing sebastian/code-unit (1.0.8): Extracting archive
- Installing sebastian/cli-parser (1.0.1): Extracting archive
- Installing phpunit/php-timer (5.0.3): Extracting archive
- Installing phpunit/php-text-template (2.0.4): Extracting archive
- Installing phpunit/php-invoker (3.1.1): Extracting archive
- Installing phpunit/php-file-iterator (3.0.5): Extracting archive
- Installing theseer/tokenizer (1.2.1): Extracting archive
- Installing sebastian/lines-of-code (1.0.3): Extracting archive
- Installing sebastian/complexity (2.0.2): Extracting archive
- Installing sebastian/code-unit-reverse-lookup (2.0.3): Extracting archive
- Installing phpunit/php-code-coverage (9.2.8): Extracting archive
- Installing doctrine/instantiator (1.4.0): Extracting archive
- Installing phpspec/prophecy (1.14.0): Extracting archive
- Installing phar-io/version (3.1.0): Extracting archive
- Installing phar-io/manifest (2.0.3): Extracting archive
- Installing myclabs/deep-copy (1.10.2): Extracting archive
- Installing phpunit/phpunit (9.5.10): Extracting archive
59 package suggestions were added by new dependencies, use `composer suggest` to see details.
Generating optimized autoload files
> Illuminate\Foundation\ComposerScripts::postAutoloadDump
> @php artisan package:discover --ansi
Discovered Package: facade/ignition
Discovered Package: fruitcake/laravel-cors
Discovered Package: laravel/sail
Discovered Package: laravel/sanctum
Discovered Package: laravel/tinker
Discovered Package: nesbot/carbon
Discovered Package: nunomaduro/collision
Package manifest generated successfully.
78 packages you are using are looking for funding.
Use the `composer fund` command to find out more!
> @php artisan vendor:publish --tag=laravel-assets --ansi
No publishable resources for tag [laravel-assets].
Publishing complete.
> @php artisan key:generate --ansi
Application key set successfully.
상기와 같이 composer 명령을 통해 설치가 완료되었습니다.
Nginx 설정
#server {
# listen 80;
# server_name laravel.com.co;
# return 301 https://laravel.com.co$request_uri;
#}
server {
listen 80;
listen [::]:80;
# For https
# listen 443 ssl;
# listen [::]:443 ssl ipv6only=on;
# ssl_certificate /etc/nginx/ssl/default.crt;
# ssl_certificate_key /etc/nginx/ssl/default.key;
server_name tailerbox.com web.tailerbox.com api.tailerbox.com;
root /var/www/tailerbox/public;
index index.php index.html index.htm;
location / {
try_files $uri $uri/ /index.php$is_args$args;
}
location ~ \.php$ {
try_files $uri /index.php =404;
fastcgi_pass php-upstream;
fastcgi_index index.php;
fastcgi_buffers 16 16k;
fastcgi_buffer_size 32k;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
#fixes timeouts
fastcgi_read_timeout 600;
include fastcgi_params;
}
location ~ /\.ht {
deny all;
}
location /.well-known/acme-challenge/ {
root /var/www/letsencrypt/;
log_not_found off;
}
error_log /var/log/nginx/tailerbox_error.log;
access_log /var/log/nginx/tailerbox_access.log;
}
상기와 같이 Nginx 에 설치된 경로로 접근하기 위한 설정파일을 생성 후 Nginx 를 재시작 합니다.
문제없이 설치가 되었다면 nginx 를 통해 아래와 같이 라라벨 메인페이지로 접근이 가능합니다.

'Framework > Laravel' 카테고리의 다른 글
| [Laravel] i18n 국제화 적용하기 (0) | 2021.11.19 |
|---|---|
| [Laravel] Error 핸들링 (CustomException) (0) | 2021.11.19 |
| [Laravel] 라우팅 정책 변경하기 (API 를 도메인 기반으로) (0) | 2021.11.18 |
