Visual Studio Code에서 PHP 개발하기

 

 

 

Visual Studio Code에서 PHP 개발을 시작해보자. 우선 Bitnami WAMP를 통해 아파치 웹서버와 PHP 인터프리터를 설치해야한다. 아래의 블로그에서 설치 과정을 자세히 알려주니 참고를 추천드린다.

 

 

비트나미(bitnami) WAMP 아파치 웹서버 설치 방법

 

설치를 완료하면 개발 툴이 필요하다. 개발 툴은 Visual Studio Code를 사용할 것이다. VS Code는 아래에서 다운로드 받으면 된다.

 

Download Visual Studio Code - Mac, Linux, Windows

 

기본적인 개발 구조는 아래와 같다.

 

 

 

 

 

VS Code로 소스코드 작성하기

 

1. 웹 문서 저장 위치

 

위 그림과 같이, VS Code에서 PHP 소스코드를 작성 한 후 Disk에 저장할 것이다. 그럼 저장되는 Disk의 위치를 알아야한다. 저장되는 위치는 Binami 아파치 폴더의 htdocs 폴더로 정한다. 아파치 서버가 이 곳을 웹문서의 root로 지정했기에 VS Code로 작성된 PHP문서는 모두 이곳에 저장할 것이다. root 안에 저장된 웹문서들은 웹브라우저에서 127.0.0.1 주소로 접근이 가능하다. 저장 위치를 확인하였으니 본격적으로 VS Code를 사용하여 PHP 개발을 해보자.

 

 

.

 

VS Code에서 Bitnami의 아파치 폴더의 htdocs 폴더를 열어준다. 이제부터 VS Code에서 작성되는 php 문서는 모두 htdocs 폴더에 저장된다. 앞서 말했듯, 해당 폴더는 아파치 웹서버가 지정한 root 폴더로, 이 안에 저장된 웹문서는 웹브라우저에서 127.0.0.1 주소로 접근할 수 있다.

 

 

위에 보여지는 .php 파일들은 내가 php공부를 하면 작성한 문서들이다. 이렇듯 VS Code에서 php 문서를 생성하고 삭제하면 htdocs 폴더 안에 php 파일이 생성, 삭제된다.

 

2. VS Code에 PHP 인터프리터 경로지정

 

VS Code에서 php 파일을 만들면 아래와 같은 경고가 뜬다.

 

 

VS Code가 PHP 인터프리터를 인식하지 못해서 발생하는 문제이다. 그러나 우리는 VS Code로 PHP 코드를 작성하여 Disk에 저장할 목적이지 PHP 인터프리터를 실행할 목적이 아니다. PHP 인터프리터 실행은 아파치 서버가 PHP 인터프리터에게 PHP 코드 번역을 요청할 때 이루어진다. 그리고 아파치 서버는 이미 PHP 인터프리터 경로를 알고 있다. 그러므로 굳이 VS Code에 PHP 인터프리터 경로 설정을 안 해줘도 아파치 서버가 PHP 인터프리터를 잘 실행해준다.

 

그러나 PHP 코딩을 좀 더 편하게 하려면 VS Code에 확장프로그램을 설치해야하는데, 확장프로그램이 php 인터프리터의 접근 경로를 요구하므로 경로 설정이 필요하다. 경로 설정에는 두 가지 방법이 있다.

 

1) 환경변수로 PHP 인터프리터 경로 설정하기

 

OS는 특정 프로그램 실행 명령을 받으면 현재 위치한 디렉토리에서 프로그램명과 일치하는 프로그램을 탐색한다. 만약 없다면 Path에 지정된 경로에 접근하여 해당 프로그램명과 일치한 프로그램명을 탐색한다. 우리는 php 인터프리터(php.exe) 를 실행해야한다. 그러므로 php.exe가 위치한 디렉토리의 경로를 Path 등록해야한다.

 

 

위 경로에 php.exe가 위치하고 있으니 이를 Path에 등록해보자.

 

과정 : 내PC 우클릭 > 속성 > 고급시스템 설정 > 환경변수 > 시스템 변수

 

PHP 인터프리터가 있는 폴더의 경로를 시스템 변수로 만들어 준다. 그리고 Path에 그 경로를 저장해준다.

 

1-1) 시스템 변수 만들기

 

새로만들기 버튼을 눌러 시스템 변수를 만든다. 변수이름은 PHP 변수값은 php.exe가 위치한 디렉토리로 설정해준다.

 

1-2) Path 등록하기

 

 

Path에서 시스템 변수는 %%로 구분해준다. 이제 cmd 창에서 아무 디렉토리에서나 php를 실행시켜보자.

 

 

php.exe가 위치한 디렉토리가 아니지만 php 명령어를 잘 수행하고 있음을 알 수 있다. 이는 OS가 Path를 통해 php.exe의 상위폴더를 탐색했기에 가능한 일이다. 그러므로 VS code도 OS에게 php.exe 프로그램 실행을 요청하면 Path경로를 통해 실행할 수 있게 된다.

 

2) VS Code에 직접 경로 설정하기

 

환경변수로 설정하지 않고 VS Code 프로그램에 직접 php 인터프리터의 경로를 설정할 수 있다.

 

1. VS Code를 실행하고 키보드에서 f1을 누른다.

 

그럼 위와 같이, 검색창이 하나 뜬다.

 

2. 검색창에 settings를 입력하면 Open Settings(JSON)이 뜬다.이를 클릭한다.

 

 

php.validate.executablePath 속성에 php.exe의 경로를 저장해준다. 환경변수를 지정할 때는 Path에 php.exe의 상위폴더인 php 디렉토리의 경로만 등록했다. 그 이유는 OS가 디렉토리를 탐색하기 때문이다. 그러나 이번에는 VS code가 직접 접근하는 것이기에(?) php.exe의 경로를 넣어준다.

 

 

이렇게 두 가지 방법 중 하나를 선택하여 사용하면 VS Code는 PHP 인터프리터에 언제든 접근할 수 있게 된다. 앞서 말했 듯, VS Code에 PHP 인터프리터 경로설정을 해준 이유는 PHP 코딩을 좀 더 쉽게 할 수 있도록 도와주는 확장프로그램 때문이다. 그렇다면 확장 프로그램에 대해서 알아보자.

PHP 개발 확장 프로그램

출처 입력

이클립스는 JAVA 전용 IDE로 JAVA 언어 개발을 위한 여러 기능을 제공한다. 반면에 VS Code는 특정 언어 전용 IDE가 아니므로 개발에 필요한 기능들은 확장프로그램을 설치해서 제공받아야한다.

 

PHP 개발을 위해 기본적으로 필요한 확장프로그램은 두 가지가 있다.

 

1. PHP IntelliSense

PHP intelliSense는 코딩 과정에서 자동완성 같은 코딩을 좀 더 윤택하게 해주는 기능을 제공한다.

 

2. PHP Debug

PHP Debug는 디버깅 기능을 지원해주는 확장 프로그램이다.

 

 

 

Extensions 탭에 가서 두 가지를 설치하면 된다. Install 버튼을 누르고 설치가 완료되면 톱니바퀴 모양이 된다. PHP Debug 프로그램은 설치 후 별도의 설정이 더 필요하다. ( PHP Debug 추가 설정은 과정이 복잡하고 저도 이걸 왜 해야하는지 이해를 잘 못했어요. 디버깅 과정을 위한 최적화 작업? 이라는데 정확히 이해를 못해서 아래에 링크를 겁니다. (13분 50초부터) )

 

 

 

여기까지 하면 PHP 개발을 위한 모든 준비가 완료된 것이다. 다음 포스팅부터는 실제 PHP 개발을 진행해보겠다.