개요

지난 시간에 앤서블(Ansible)을 이용하여 라라독(Laradock)을 설치하였습니다. 이제 라라벨(Laravel)을 개발하기 위해 라라벨(Laravel)을 설치하고 라라벨(Laravel) 프로젝트를 생성해 보겠습니다.

이 블로그는 아래에 있는 블로그에 연재물입니다. 이해를 돕기 위해 아래에 블로그 리스트를 먼저 진행하시는걸 추천합니다.

• vagrant 설치 및 사용법
• 앤서블 설치
• 앤서블 플레이북
• 앤서블&도커
• 앤서블&라라독

php와 composer 설정

자신의 로컬 머신(host system)에 php와 composer가 설치되어있다면 이 단계는 추가하지 않으셔도 됩니다. 라라벨(Laravel) 프로젝트를 생성하기 위해 php와 composer를 가상 머신(guest system)에 설치할 예정입니다.

지금까지 만든 폴더에 php와 composer를 설치하는 앤서블 플레이북(Ansible Playbook)의 role을 추가합니다.

|-- ansible
|    |-- init
|    |    |-- tasks
|    |    |    |-- main.yml
|    |-- docker
|    |    |-- tasks
|    |    |    |-- main.yml
|    |-- laradock
|    |    |-- tasks
|    |    |    |-- main.yml
|    |-- php
|    |    |-- tasks
|    |    |    |-- main.yml
|    |-- playbook.yml
|-- Vagrantfile

앤서블 플레이북(Ansible Playbook) 파일에도 새롭게 추가한 php의 role을 추가합니다.

---
- hosts: localhost
  connection: local
  roles:
    - init
    - docker
    - laradock
    - php

추가한 앤서블 플레이북(Ansible Playbook)의 role 파일인 php/tasks/main.yml 파일을 아래와 같이 수정합니다.

---
- name: Add php7.2 repo
  apt_repository:
    repo: 'ppa:ondrej/php'
  tags: php

- name: Install php
  become: true
  apt:
    pkg:
      - php7.2
      - php7.2-mbstring
      - php7.2-xml
    state: present
    update_cache: yes
  tags: php

- name: check composer
  stat: path=/usr/local/bin/composer
  register: composer_bin
  tags: php

- block:
  - name: download composer
    get_url:
      url: https://getcomposer.org/installer
      dest: /tmp/installer

  - name: install composer
    shell: cat /tmp/installer | php -- --install-dir=/usr/local/bin

  - name: rename composer.phar to composer
    shell: mv /usr/local/bin/composer.phar /usr/local/bin/composer

  - name: make composer executable
    file:
      path: /usr/local/bin/composer
      mode: a+x
      state: file

  when: not composer_bin.stat.exists
  tags: php

- name: stop apache2
  become: true
  shell: update-rc.d apache2 disable
  tags: php

추가한 role의 task를 하나하나 살펴봅시다.

- name: Add php7.2 repo
  apt_repository:
    repo: 'ppa:ondrej/php'
  tags: php

php 7.2를 설치하기 위해 apt에 php7.2의 저장소(repository)를 추가합니다.

- name: Install php
  become: true
  apt:
    pkg:
      - php7.2
      - php7.2-mbstring
      - php7.2-xml
    state: present
    update_cache: yes
  tags: php

php7.2와 라라벨(Laravel) 설치 및 실행에 필요한 php모듈들을 설치합니다.

- name: check composer
  stat: path=/usr/local/bin/composer
  register: composer_bin
  tags: php

composer 설치에 앞서 composer의 실행 파일이 존재하는지 체크한 후 그 결과를 composer_bin에 저장합니다.

- block:
  ...
  when: not composer_bin.stat.exists
  tags: php

여러 task를 블록(block)으로 묶습니다. 또한 이 블록은 우리가 위에서 저장한 composer_bin이 존재하지 않을 경우에만 실행합니다.

블록(block)안을 하나하나 살펴보겠습니다.

- name: download composer
  get_url:
    url: https://getcomposer.org/installer
    dest: /tmp/installer

composer 설치 스크립트를 /tmp/installer 파일로 다운로드 합니다.

- name: install composer
    shell: cat /tmp/installer | php -- --install-dir=/usr/local/bin

composer 설치 스크립트를 이용하여 /usr/local/bin에 composer를 설치합니다.

- name: rename composer.phar to composer
  shell: mv /usr/local/bin/composer.phar /usr/local/bin/composer

설치된 composer 파일(composer.phar)의 이름을 composer로 변경합니다.

- name: make composer executable
    file:
      path: /usr/local/bin/composer
      mode: a+x
      state: file

composer가 실행 가능하도록 권한을 변경합니다.

- name: stop apache2
  become: true
  shell: update-rc.d apache2 disable
  tags: php

php 설치이후 가상 머신(guest system)을 재시작할시 apache2 서버가 기동하여 같은 포트(port)를 사용하는 도커(Docker)가 기동되지 않는 문제가 생깁니다. apache2 서버가 가상 머신(guest system)이 재시작될때 재실행되지 않도록 설정합니다.

php와 composer 설치

위에서 만든 앤서블 플레이북(Ansible Playbook)의 role을 실행하여 php와 composer를 설치합니다. 우리는 이 role만 실행할 수 있도록 태그(tag)를 지정했으므로 태크(tag) 옵션을 추가한 앤서블 플레이북(Ansible Playbook) 명령어를 아래와 같이 실행합니다.

#vagrant ssh
sudo ansible-playbook /vagrant/ansible/playbook.yml --tags 'php'

아래에 명령어로 설치가 잘 되었는지 확인합니다.

#vagrant ssh
php --version
composer --version

라라벨 프로젝트 생성

아래에 명령어로 라라벨(Laravel) 프로젝트를 생성합니다. 기존에 라라벨(Laravel) 프로젝트를 가지고 있는 분들은 이 부분을 건너뛰셔도 좋습니다.

#vagrant ssh
cd /vagrant
composer create-project laravel/laravel app

라라벨 프로젝트 설정

우리는 이전 블로그(앤서블&라라독)에서 라라독(Laradock) 설치 role을 아래와 같이 작성하였습니다.

...
- name: change project folder
  replace:
    path: /vagrant/lib/laradock/.env
    regexp: 'APP_CODE_PATH_HOST=*.*'
    replace: 'APP_CODE_PATH_HOST=/vagrant/app'
  tags:
    - replace
...

이 부분에서 라라독(Laradock)의 workspace 도커(Docker)가 생성될 때 /vagrant/app 폴더와 동기화되도록 설정하였습니다. 따라서 우리는 새로운 프로젝트를 /vagrant 폴더에 /app이라는 폴더명으로 생성하였습니다. 여러분이 기존에 라라벨(Laravel) 프로젝트를 가지고 계신다면 해당 프로젝트를 /vagrant/app 폴더로 복사하거나 이전 시간에 만든 라라독(Laradock)의 role중에 위에 해당하는 부분을 여러분의 라라벨(Laravel) 프로젝트 폴더로 지정하여 사용하시기 바랍니다.

라라벨 프로젝트 확인

이제 다시 localhost에 접속하면 아래와 같이 라라벨(Laravel)의 기본 화면이 보이는 것을 확인할 수 있습니다.

라라벨(Laravel) 설정이 제대로 되지 않았다면 아래와 같은 500 에러 화면이 나옵니다.

라라벨(Laravel) 설정중 아래에 항목들을 빼먹었는지 확인해봅니다. composer create-project laravel/laravel app 명령어로 라라벨(Laravel) 프로젝트를 새로 생성하였다면 아래에 설정은 자동으로 진행됩니다.

라라벨(Laravel) 프로젝트가 필요한 라이브러리를 설치했는가?

composer install

라라벨(Laravel)의 환경 파일을 생성하였는가?

cp .env.example .env

라라벨(Laravel)의 키를 생성하였는가?

php artisan key:generate

phpmyadmin

데이터베이스를 다루기 위해 설치한 phpmyadmin에 접속해 봅니다. localhost:8080으로 접속하면 phpmyadmin화면이 보입니다.

아무 설정도 하지 않았으므로 아래에 정보를 입력하여 접속합니다.

server: mysql
username: root
password: root

이렇게 접속한 후 아래와 같은 화면을 볼 수 있습니다.

화면 가운데에 Change password를 눌러 자신이 원하는 패스워드로 변경합니다.

상단 메뉴에서 Database를 눌러 라라벨(Laravel)과 연결하고자 하는 데이터베이스를 생성합니다.

라라벨 DB 설정

위에서 phpmyadmin을 사용해 만든 데이터베이스(Database)를 라라벨(Laravel) 프로젝트에 연결할 필요가 있습니다. 라라벨(Laravel) 프로젝트의 환경 파일인 .env를 열면 아래와 같은 내용을 확인할 수 있습니다.

...
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret
...

이 부분을 아래와 같이 수정합니다. DB_DATABASE와 DB_PASSWORD 부분은 여러분이 설정한 내용을 입력합니다.

...
DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=app
DB_USERNAME=root
DB_PASSWORD=*******
...

이렇게 수정하였다면 아래에 라라벨(Laravel) 명령어를 통해 라라벨(Laravel)이 기본적으로 제공하는 사용자 테이블(User Table)을 생성해 봅니다.

# vagrant ssh
# sudo docker exec -it laradock_workspace_1 bash
php artisan migrate

라라벨(Laravel)이 기본적으로 제공하는 사용자 테이블(User Table)을 사용하지 않을 예정이라면 라라벨(Laravel) 명령어를 통해 생성한 테이블을 제거합니다.

php artisan migrate:rollback

완료

vagrant, 앤서블(Ansible), 라라독(Laradock)을 이용하여 라라벨(Laravel) 개발 환경을 구축해보았습니다. 또한 이번 개발 환경 구축을 통해 앤서블(Ansible)과 도커(Docker)를 살짝 맛보았습니다. 앤서블(Ansible)과 도커(Docker)를 잘 활용하면 말로만 듣던 DevOps를 할 수 있는 개발자가 되는게 아닌가 싶습니다.

앞으로도 이 개발 환경 카테고리에는 개발 환경 구축, 도커(Docker), 앤서블(Ansible)과 관련된 내용을 추가할 예정입니다. 또한 라라벨(Laravel) 개발에 관련한 블로그는 라라벨 카테고리에 작성할 예정이니 많이 참고하시기 바랍니다.

지금까지 만든 라라벨(Laravel) 개발 환경을 아래에 저장소(Repository)에서 확인하실 수 있습니다.

• https://github.com/dev-yakuza/laravel-devtool

참고

• https://laradock.io/documentation/

Github Sponsor Buy me a coffee

제 블로그가 도움이 되셨나요? 하단의 댓글을 달아주시면 저에게 큰 힘이 됩니다!

앱 홍보

지금 보고 계신 블로그를 작성하는 Deku가 개발한 앱을 한번 사용해보세요.
Deku가 개발한 앱은 Flutter로 개발되었습니다.

관심있으신 분들은 앱을 다운로드하여 사용해 주시면 정말 감사하겠습니다.

어린이용 단어 공부 앱

블라부

세상의 모든 정보를 모아보다

씨로그

JLPT 일본어 단어앱

일단 공부

토익 영어 단어앱

토익 단어앱

중고등 영어 단어앱

중고등 영단어앱

HSK 중국어 단어앱

중국어 단어앱

독일어 단어앱

독일어 단어장

러시아어 단어앱

러시아어 단어장

아랍어 단어앱

아랍어 단어장

인도네시아 단어앱

인도네시아 단어장

프랑스어 단어앱

프랑스어 단어장

스페인어 단어앱

스페인어 단어장

책 홍보

블로그를 운영하면서 좋은 기회가 생겨 책을 출판하게 되었습니다.

아래 링크를 통해 제가 쓴 책을 구매하실 수 있습니다.
많은 분들에게 도움이 되면 좋겠네요.

• 쿠팡: 구매하기
• yes24: 구매하기
• 교보문고: 구매하기
• 알라딘: 구매하기

• 쿠팡: 구매하기
• yes24: 구매하기
• 교보문고: 구매하기
• 알라딘: 구매하기

• 쿠팡: 구매하기
• yes24: 구매하기
• 교보문고: 구매하기
• 알라딘: 구매하기