Laravel 설치하기. 라라벨 개발 환경 구축하기

오늘은 라라벨 개발 환경을 구축하는 방법에 대해서 알아보려고 합니다!

이번에 강의를 시작으로 앞으로 라라벨 강의를 조금씩 업로드 해보려고 합니다.

라라벨을 사용하면서 웹 서비스 개발 속도가 많이 향상 되었고, 관리하고 유지보수하는 것도 쉬워져서 라라벨을 더 많은 사람들이 사용할 수 있게! 해보려고 합니다.

라라벨 공식 사이트에서 모든 설명과 도큐멘트를 볼 수 있지만! 영어라서... 쉽게 시작하지 못하는 사람들이 많을 것 같습니다. 일단 이번 강의에서는 사용자의 컴퓨터에 라라벨을 설치하고, 라라벨 서버를 열어보는 것에서 마무리 짓도록 하겠습니다.

라라벨 공식 사이트 : laravel.com

라라벨을 사용하기 위해서는 컴퓨터 및 서버에 다음과 같은 패키지들이 설치되어 있어야 합니다.

• 버전 7.1.3의 PHP
• OpenSSL PHP 확장 패키지
• PDO PHP 확장 패키지
• Mbstring PHP 확장 패키지
• Tokenizer PHP 확장 패키지
• XML PHP 확장 패키지
• Ctype PHP 확장 패키지
• Json PHP 확장 패키지

그리고 라라벨은 의존성 관리도구로 composer와 npm을 사용하기 때문에 composer와 npm 또한 설치되어 있어야 합니다.

Composer 설치하기 : 2018/03/03 - [Web/PHP] - [PHP] 의존성 관리 도구 Composer 설치하기

npm 설치하기 : 2018/03/06 - [Web/Node.js] - [Node.js] Node.js 설치하기

Node.js를 설치하면 npm이 따라옵니다!

그러면 본격적으로 라라벨 설치를 시작해 보겠습니다!

터미널(Terminal)을 열고, 라라벨 설치 명령어를 입력해 줍니다.

$ composer create-project --prefer-dist laravel/laravel [프로젝트 이름]

그러면 컴포저는 자동으로 라라벨 프로젝트를 생성해 줍니다.

생성된 라라벨 프로젝트 폴더로 이동해보죠! 라라벨 프로젝트의 기본 골격입니다.

각 파일들에 대한 간단한 설명입니다.

• /app : 라라벨 프로젝트의 컨트롤러, 모델이 담긴 폴더입니다.

• /config : 프로젝트 관련된 설정 파일이 들어 있는 폴더입니다.
  

• /database : 데이터베이스 마이그레이션 정보가 담겨 있습니다.

• /public : css, js, image 폴더가 들어 있습니다. asset 폴더입니다.

• /resources : webpack을 이용해서 처리되기 전의 css, js 파일이 들어 있습니다.

• /routes : 라우터가 담겨있는 폴더입니다.

• /storage : 각종 로그가 담겨있는 폴더입니다.

• /vender : composer로 설치한 패키지들이 담겨 있습니다.

• .env : 라라벨 환경 설정 파일입니다. 라라벨을 실행시키기 위해 꼭 필요한 파일입니다.

• artisan : 라라벨 프로젝트의 CLI 프로그램입니다. 아티즌을 통해 모든 명령을 하게 됩니다.

• composer.json : 컴포저를 통해 프로젝트에서 사용할 패키지 리스트입니다.

• webpack.mix.js : 웹팩을 사용하기 위한 파일입니다. 웹팩은 나누어져 있는 여러개의 css, js 파일을 하나의 파일로 묶어줍니다.

/storage 폴더에는 라라벨에서 어플리케이션 로그를 저장하기 때문에 접근 권한을 777로 설정해 놓아야 합니다.

$ chmod -R 777 storage

만약 프로젝트 폴더에 .env가 없다면 프로젝트를 실행할 수 없습니다.

그럴 때는 .env.example 파일을 복사해서 생성하고, 수정해 주면 됩니다.

$ cp .env.example .env

서비스를 실행하기 위해서는 또한, composer.json에 적힌 모든 패키지가 설치 되어 있어야 하고, package.json에 적힌 모든 패키지가 설치 되어 있어야 합니다.

$ composer install
$ npm install

설치를 완료하면 프로젝트를 실행해 줍니다.

라라벨 프로젝트 실행은 CLI인 artisan을 이용합니다.

$ php artisan serve

그러면 서버가 8000번 포트에서 정상적으로 실행되는걸 볼 수 있습니다.

만약 다른 포트에서 서버를 열고 싶다면,

$ php artisan serve --port=[포트번호]

를 해주시면 됩니다.

그러면 브라우저에서 여러보죠! 'localhost:8000' 또는 '127.0.0.1:8000'을 입력하세요.

만약 브라우저에서 다음과 같은 에러 메세지를 보여준다면, .env 파일에 어플리케이션 키가 생성이 되지 않았다는 뜻입니다.

그럴 때는 artisan을 이용해서 .env파일에 key를 생성해 주어야 합니다.

$ php artisan key:generate

키를 생성하고 나서는 서버를 재시동 해주어야 합니다.

다시 접속해 보면!

짜잔! 라라벨 설치를 무사히 끝냈습니다!

그러면 다음 강좌에서 뵐께요~ 혹시 오류가 나거나 질문 사항이 있으면 주저하지 말고 댓글로 달아주세요!