[PHP 입문] PHP 설치 가이드: Windows, Mac, Linux 완벽 정리

PHP 설치, 어렵게만 느껴지셨나요? 진짜 따라만 하면 10분 안에 끝나요!

안녕하세요 여러분! 웹 개발의 세계에 발을 들인 지 얼마 안 됐을 때, 저도 PHP를 처음 설치하려고 엄청 고생했던 기억이 있어요. 무슨 'XAMPP'니 '환경변수'니 처음 듣는 단어들 투성이에… 머리가 띵했죠. 😵 그런데 지나고 보니까, 한 번만 정확히 짚고 넘어가면 진짜 쉬운 게 바로 PHP 설치더라고요. 저처럼 헤매지 마시라고, 오늘은 PHP 설치를 처음부터 끝까지 단계별로 알려드릴게요. 윈도우, 맥, 리눅스까지 모두 커버하니까 운영체제 상관없이 누구나 따라할 수 있어요. "PHP 설치가 이렇게 쉬웠어?" 하고 놀랄 준비 되셨나요?

목차

PHP 설치 전 알아야 할 것들 Windows에서 PHP 설치하기 Mac에서 PHP 설치하기 Linux(Ubuntu)에서 PHP 설치하기 설치 후 PHP 버전 확인하는 방법 설치 중 자주 발생하는 문제 해결법

PHP 설치 전 알아야 할 것들

설치하기 전에 잠깐! PHP는 그냥 설치한다고 끝이 아니에요. PHP는 웹 서버(Apache, Nginx 등)와 함께 작동하므로, 대부분은 로컬 개발 환경 도구(XAMPP, MAMP, LAMP 등)를 함께 사용하게 됩니다. 그리고 OS에 따라 설치 방식이 완전히 다르다는 점도 알아두세요.

🔧 PHP 단독 설치도 가능하지만, 보통은 웹 서버+데이터베이스까지 같이 설치하는 통합 패키지가 편해요!

Windows에서 PHP 설치하기

윈도우 환경에서는 XAMPP라는 도구를 사용하는 것이 가장 간단하고 빠릅니다.

이 하나만 설치하면 PHP, Apache, MySQL이 한꺼번에 깔려요!

단계	설명
1	XAMPP 공식 사이트(apachefriends.org)에서 최신 버전 다운로드
2	설치 마법사 안내에 따라 Next → Next → Finish
3	XAMPP Control Panel에서 Apache 실행 → 브라우저에서 localhost 확인

Mac에서 PHP 설치하기

맥에서는 brew 명령어로 설치하는 게 제일 간편합니다. MAMP를 써도 되지만, 커맨드라인이 익숙하다면 이쪽이 깔끔해요.

1. 터미널 열기
2. Homebrew 설치 (이미 있다면 생략): /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3. PHP 설치: brew install php
4. 설치 확인: php -v

Linux(Ubuntu)에서 PHP 설치하기

리눅스는 다소 진입장벽이 있지만, 오히려 서버 환경과 가장 유사하기 때문에 학습에 큰 도움이 됩니다. 특히 Ubuntu 기준으로 아래의 명령어만 입력하면 설치가 매우 간단해요.

1. sudo apt update
2. sudo apt install php
3. php -v로 설치 확인
4. 웹 서버도 함께 설치하려면 sudo apt install apache2

설치 후 PHP 버전 확인하는 방법

설치가 잘 되었는지 확인하는 방법은 아주 간단해요. 아래 명령어를 터미널(또는 명령 프롬프트)에 입력해보세요.

명령어	설명
php -v	설치된 PHP 버전 정보 출력
which php	PHP 실행 파일 경로 확인

 

독립몰 구축을 위한 이커머스 플랫폼 비교 분석

설치 중 자주 발생하는 문제 해결법

처음 설치하다 보면 예상치 못한 에러가 튀어나오곤 하죠. 당황하지 마세요! 아래 리스트에서 자주 발생하는 문제와 해결책을 정리했어요.

• Apache가 실행되지 않음 → 이미 포트 80 사용 중일 수 있음 (Skype 종료하거나 포트 변경)
• php -v 안 됨 → 환경 변수(PHP 설치 경로) 누락, 다시 설정 필요
• php 파일 실행 안 됨 → 웹 서버 작동 여부 및 폴더 위치 확인 (htdocs 안에 넣었는지?)

Q XAMPP랑 PHP 단독 설치 중 뭐가 더 좋은가요?

초보자라면 XAMPP가 훨씬 쉽고 편리합니다. PHP, Apache, MySQL을 한 번에 설치할 수 있어요.

단독 설치는 고급 사용자가 직접 환경을 구성할 때 적합합니다.

A 처음이라면 XAMPP 강력 추천이에요!

Q PHP 설치 후 바로 코딩 시작해도 되나요?

네! 설치만 완료되면 바로 PHP 파일을 만들어서 브라우저에서 실행해볼 수 있어요.

단, 웹 서버가 켜져 있어야 한다는 점 잊지 마세요.

A 그럼요! 바로 실습 Go Go!

Q Mac에서는 PHP가 기본으로 설치되어 있지 않나요?

예전 macOS 버전에서는 기본 설치돼 있었지만, 최신 버전부터는 제외되었어요. Homebrew로 수동 설치해야 합니다.

A 이젠 수동 설치가 기본이에요.

Q PHP는 어떤 코드 편집기가 좋을까요?

VS Code가 가장 인기 많고 추천도 많이 받아요. 자동완성, 확장 기능, 터미널 내장 등 초보자와 전문가 모두에게 좋습니다.

A 단연 VS Code! 깔아두면 후회 안 해요.

Q PHP 설치 후 php.ini는 꼭 설정해야 하나요?

기본 설정으로도 대부분 작동하지만, 에러 로그 경로 설정이나 확장 모듈 활성화 등 커스터마이징할 때 필요합니다.

A 꼭은 아니지만 설정해두면 좋아요!

Q PHP 설치 후 브라우저에서 화면이 안 나와요. 왜죠?

웹 서버(Apache, Nginx 등)가 실행되고 있는지 확인해보세요. 그리고 PHP 파일은 반드시 웹 루트 폴더 안에 있어야 합니다 (예: htdocs).

A 서버가 꺼졌거나 폴더 위치가 잘못됐을 수 있어요!

PHP 설치, 사실 해보면 별거 아니죠?

처음에는 용어도 낯설고 창이 몇 개나 뜨고, 이게 뭔가 싶을 수 있지만… 막상 하나씩 따라 하다 보면 ‘어? 나 벌써 끝냈네?’ 싶은 순간이 와요. 저도 처음엔 XAMPP를 몇 번이나 지우고 다시 설치했는지 몰라요. 그런데 그 시행착오가 있었기에 지금은 너무 익숙하고, 누군가에게 설치법을 알려주는 입장이 됐죠. 여러분도 분명 그렇게 될 수 있어요! 이 글 하나면, 앞으로 누가 "PHP 어떻게 설치해?"라고 물었을 때 자신 있게 "내가 알려줄게!"라고 말할 수 있을 거예요.

천천히, 하지만 꾸준히 배우는 우리 모두를 응원합니다 💜