라라벨(laravel) 개발 환경 구축하기-1 (Windows & 도커(docker) & 라라독(laradock)활용)

이번 방학동안 쪼랩에서 Docker, Visual Studio Code, git, laravel 등을 공부하고 다뤄보고 있습니다. 모두 처음 다뤄보는 것들이라 공부하면서 아래와 같이 정리를 해둡니다.

라라벨을 공부하기 위해 개발 환경을 구축하는 방법이 몇가지가 있습니다만,

여기서는 윈도우즈(windows)환경에서 도커(docker)를 활용하되, 라라벨 개발을 위한 다양한 도커 이미지 및 컨테이너를 손쉽게 생성할 수 있도록 도와주는 라라독(laradock)을 활용합니다.

 

0. 기본으로 설치되어야 할 것

  가. 도커(docker)가 설치 및 실행이 되어 있어야 합니다. 설치하는 방법은 여기를 눌러 참고하세요.

  나. git 이 설치되어 있어야 합니다. 설치 방법은 구글 검색을 참고하세요.

  다. 에디터는 Visual Studio Code를 사용하며, 저의 경우 터미널 쉘은 git bash를 사용합니다.

 

1. 작업 폴더 생성 및 이동 (여기서는 예시로 laravel 폴더를 생성함.)

mkdir laravel && cd laravel

 

2. 아래 명령을 입력하여 깃허브(github)에서 laradock 파일들을 다운로드합니다. 그럼 많은 폴더와 파일이 들어있는 laradock이라는 폴더가 생성됩니다.

git clone https://github.com/Laradock/laradock.git

 

3. 새로 생성된 laradock 폴더로 이동 후, 이미 폴더 안에 있는 .env-example 파일을 이용하여 설정 파일(.env)을 생성해줍니다.

cd laradock
cp .env.example .env

 

4. .env 파일을 열어서 필요한 사항을 수정합니다. 각자 설치하는 프로그램에 따라 해당되는 부분을 찾아 수정하면 됩니다. 여기서는 가장 기본적인 것만 수정하도록 하겠습니다.

(8번줄) APP_CODE_PATH_HOST=../munglara   //프로젝트 경로 이름
(17번줄) DATA_PATH_HOST=../munglara/dbdata   //데이터베이스 저장 경로
(36번줄) COMPOSE_PROJECT_NAME=munglara  //컨테이너명 변경

(384번줄) MYSQL_VERSION=latest      //mysql 설정들
(385번줄) MYSQL_DATABASE=munglaradb
(386번줄) MYSQL_USER=munglara
(387번줄) MYSQL_PASSWORD=munglarapass
(389번줄) MYSQL_ROOT_PASSWORD=munglarapass

(542번줄) PMA_USER=munglara          //phpmyadmin 설정들
(543번줄) PMA_PASSWORD=munglarapass
(544번줄) PMA_ROOT_PASSWORD=munglarapass

8번줄은 뒷부분에 생성할 라라벨 프로젝트명을 미리 입력해둔 것입니다. 이 부분을 뒷부분에서 수정해도 되겠지만, 그럼 컨테이너를 멈췄다가 다시 실행하는 것이 귀찮아 미리 입력을 해두었습니다.

17번줄은 컨테이너 속 DB는 컨테이너가 삭제되면  DB도 모두 삭제되기 때문에, 컨테이너 밖의 컴퓨터의 특정 폴더와 연결시켜 DB 데이터를 보관할 수 있도록 하기 위합니다. 기본값은 'DATA_PATH_HOST=~/.laradock/data' 이며,  C:\Users\사용자명\.laradock\data 폴더가 생성되며 저장됩니다. 이 부분을 ../munglara/dbdata 로 수정하면 프로젝트 폴더 안에 dbdata폴더가 생성되며 이 부분에 DB가 저장됩니다. 

나머지 mysql 및 phpmyadmin 설정 부분은 원하는 대로  수정을 하시면 됩니다. 

저의 경우 저만의 .env 파일을 만들어 따로 저장해둔 후 그것을 복사해서 사용한답니다.

 

5. 아래 명령으로 자신에게 필요한 프로그램들을 설치해줍니다. 아래의 예시는 nginx, mysql, phpmyadmin 프로그램과 workspace라는 작업 영역을 만들어줍니다. 좀더 정확히 말하면 도커 허브에서 위의 나열한 프로그램들의 도커 이미지를  다운받아 자동으로 컨테이너까지 생성해 주는 것입니다. (처음 설치할 경우 시간이 조금 걸립니다.)

docker-compose up -d nginx mysql phpmyadmin workspace

 

6. 이제 라라벨 프로젝트를 만듭니다. 여기서는 예시로 munglara로 할 것이며, 이 이름은 바로 윗부분 4번 작업에서 '(8번줄) APP_CODE_PATH_HOST=../munglara   //프로젝트 경로 이름'  부분과 동일한 이름을 사용합니다. 

이부분의 작업은 좀 길지만 한줄로 입력해서 바로 작업을 할 수도 있고, 또는 만들어진 workspace 컨테이너로 들어가서 작업을 한 후 다시 빠져나오는 방법을 사용해도 됩니다.

docker-compose exec --user=laradock workspace composer create-project --prefer-dist laravel/laravel munglara

또는

docker-compose exec --user=laradock workspace bash
composer create-project --prefer-dist laravel/laravel munglara    # workspace 컨테이너 속 작업 
exit                                                              # workspace 컨테이너 속 작업

 

 

7. (중요) 앞 작업까지 하면 munglara 프로젝트 폴더 밑에 또다른 munglara 폴더가 생성된 것을 볼 수 있습니다. 내부에 생성된 munglara 폴더 안에 있는 것을 모두 바깥으로 이동해줍니다. 그리고, 내부의 munglara 폴더는 비어있을테니 지워버리면 됩니다.

 

8. 이제 http://127.0.0.1/  로 접속해보면 아래와 같은 화면을 보실 수 있습니다. (참고 - 저는 다크모드라서 화면이 어둡게 나옵니다.)

 

9. 이제 새로 생성된 프로젝트 폴더(munglara 폴더) 내에 있는 .env 파일을 열어준 후 아래 내용을 수정합니다. (앞에서 작업한 .env 파일은 laradock 폴더에 있는 것이고, 지금 작업해야 하는 것은 munglara 폴더 안에 있는 것입니다.)

DB_HOST=mysql
DB_DATABASE=munglaradb
DB_USERNAME=munglara
DB_PASSWORD=munglarapass

 

10. 마지막으로 migrate를 실행시켜 봅니다.

docker-compose exec --user=laradock workspace php artisan migrate

 

11. http://127.0.0.1:8081/   (phpmyadmin 창)을 열어 앞의 .env에서 설정했던 서버, 사용자명, 암호를 입력하고 로그인 한 후 10번에서 migrate한 DB가 보이면 정상적으로 모든 작업이 완료된 것입니다.