[Laravel] 라라벨 프레임워크 시작하기

서문

라라벨은 PHP 에서 가장 인기있는 프레임워크다. 내 블로그를 보던 사람이라면, 갑자기 웬 라라벨인가 싶겠지만, 최근 Go 를 하면서 손을 놓았던 라라벨을 모종의 이유로 다시금 딥 다이브(Deep Dive) 해야 할 상황이 생겼기에 기존에 어느정도 알고는 있었지만, 처음부터 시작하는 마음으로 블로그에도 글을 작성해보기로 했다. 설치부터 시작해서 라라벨의 요소들을 간단히 살펴보겠지만, 공식문서보다는 쉽게 설명할 것이다. 물론 라라벨에 대한 내용은 다른 블로그나 플랫폼에도 많긴하다만 내 방식대로 글을 구성해보기로 하였다.

라라벨 8.x, Composer 2.x 를 기준으로 한다.

설치하기

자, 이제 라라벨을 설치하는 것부터 시작해보자. 라라벨을 설치하기 위해서는 Composer 가 필수다. Composer 는 PHP용 패키지 매니저이며, PHP 어플리케이션을 개발할 때 다른 사람이 만든 다양한 패키지를 포함시킬 수 있도록 도와준다. 더 자세한 내용은 PHP: 의존성 관리자 — Composer 를 참고하자. 본 포스트는 Windows 에서 설치하는 것을 기준으로 한다.

 

https://getcomposer.org/download/

Composer

설치가 다 되었다면 다음과 같이 버전을 확인할 수 있다. 설치과정에서 php 바이너리가 있는 파일의 위치를 지정할 텐데, OpenSSL 등의 확장이 지정되어 있지 않다면 활성화 해야 한다.

$ composer --version
Composer version 2.0.6 2020-11-07 11:21:17

요구사항

라라벨 8.x 를 설치하기 PHP 7.3 이상이 요구되며 위해서는 다음과 같은 확장이 활성화 되어있어야 한다.

BCMath, Ctype, Fileinfo, JSON, Mbstring, OpenSSL, PDO, Tokenizer, XML

Windows 기준 php.ini 로 가면 다음과 같이 활성화 할 수 있다. 일부 JSON 같은 확장들은 PHP 버전에 따라 별도로 활성화하지 않고도 이미 내장되어 있는 것들도 있으므로 위에 있는 것을 전부 찾으려 할 필요는 없다.

;;;;;;;;;;;;;;;;;;;;;;
; Dynamic Extensions ;
;;;;;;;;;;;;;;;;;;;;;;

extension=fileinfo
extension=mbstring
extension=openssl
extension=pdo_mysql

라라벨 인스톨러 사용하기

이제 라라벨에서 제공하는 인스톨러를 사용하면 라라벨 프로젝트를 다운받을 수 있다. 먼저 인스톨러를 설치하자. 여기서 환경변수 설정이 안 되어있다면 제대로 실행이 안 될 수도 있다. 따라서 Windows 의 경우 %USERPROFILE%\AppData\Roaming\Composer\vendor\bin 경로를 Path 환경변수에 추가하면 된다.

composer global require laravel/installer

이 다음 new 커맨드를 사용하여 프로젝트를 생성할 수 있다. 라라벨의 메인 템플릿이 들어가있는 https://github.com/laravel/laravel 를 기준으로 다운로드가 될 것이다.

laravel new blog

위와 같은 커맨드를 사용하면 blog 라는 이름을 가진 프로젝트가 생성된다.

어플리케이션 키 설정하기

개발서버를 시작하기 전에 어플리케이션 키를 설정하자. 이는 쿠키를 암호화하거나 하는 용도로 사용되므로 키가 반드시 설정되어 있어야 한다. 아래의 커맨드를 통해 가능하다. 여기서 php artisan 이라는 것은 라라벨과 상호작용하는 보조 프로그램을 실행하기 위한 것이다.

php artisan key:generate

개발서버 시작하기

아래와 같이 명령어를 입력하면 개발서버를 시작할 수 있다.

$ php artisan serve
Starting Laravel development server: http://127.0.0.1:8000
[Thu Jun 10 15:07:26 2021] PHP 7.4.12 Development Server (http://127.0.0.1:8000) started

만약 어플리케이션 키가 설정되지 않았다면 위와같은 화면을 볼 수 없으니 주의하도록 하자. 이 다음에는 라라벨 Homestead & Vagrant & Virtualbox 를 사용하여 개발환경을 구성해보는 것이나 다른 방법을 사용하여 구성 해보도록 하자.

더 읽을거리

https://laravel.com/docs/8.x/installation