lsphp 명령어 오류 해결｜OpenLiteSpeed 심볼릭 링크 수정 방법

lsphp 명령어 오류는 OpenLiteSpeed 서버를 관리하다 보면 한 번쯤 만날 수 있는 문제입니다. 서버에는 PHP가 정상적으로 설치되어 있는데도 SSH에서 lsphp -v를 입력하면 명령어를 찾을 수 없다는 메시지가 출력되는 경우가 있습니다.

저 역시 OpenLiteSpeed와 CyberPanel 환경을 점검하던 중 PHP 버전을 확인하려고 했는데 명령어가 실행되지 않았습니다. PHP 자체가 삭제된 줄 알고 패키지 상태부터 확인했지만 설치는 정상 상태였습니다.

문제는 PHP가 아니라 시스템이 lsphp 실행 파일 위치를 인식하지 못하고 있었던 부분에 있었습니다.

lsphp 명령어 오류 메시지 확인

가장 먼저 아래 명령어를 입력해 보았습니다.

lsphp -v

그러자 다음과 같은 메시지가 출력되었습니다.

Command 'lsphp' not found

OpenLiteSpeed는 정상 작동하고 있었고 워드프레스 사이트도 문제없이 열렸기 때문에 PHP 자체가 손상된 상황은 아니었습니다.

이 경우에는 설치 여부보다 경로 인식 문제를 의심해 볼 필요가 있습니다.

심볼릭 링크가 원인이었던 이유

Linux에서는 특정 실행 파일을 어디서든 실행할 수 있도록 심볼릭 링크(Symbolic Link)를 사용하는 경우가 많습니다. 쉽게 말하면 실제 파일이 있는 위치를 다른 경로에서도 사용할 수 있도록 연결하는 기능입니다.

OpenLiteSpeed 환경에서는 lsphp 실행 파일이 다음과 같은 경로에 존재하는 경우가 많습니다.

/usr/local/lsws/lsphp82/bin/lsphp

하지만 시스템 PATH에 연결이 되어 있지 않으면 lsphp 명령어만 입력했을 때 실행 파일을 찾지 못하게 됩니다.

lsphp 실행 파일 위치 확인

lsphp 명령어 오류를 해결하기 전에 현재 설치된 PHP 바이너리 위치를 먼저 확인했습니다.

which lsphp

명령어 결과가 비어 있거나 경로가 출력되지 않는다면 연결이 누락된 상태일 가능성이 높습니다.

OpenLiteSpeed 서버에서는 아래 경로 중 하나에 위치하는 경우가 많습니다.

/usr/local/lsws/lsphp82/bin/lsphp

/usr/local/lsws/lsphp83/bin/lsphp

서버에 설치된 PHP 버전에 따라 숫자는 달라질 수 있습니다.

lsphp 명령어 오류 해결 방법

실행 파일 위치를 확인한 뒤 심볼릭 링크를 생성했습니다.

sudo ln -s /usr/local/lsws/lsphp82/bin/lsphp /usr/bin/lsphp

위 명령어는 실제 lsphp 실행 파일과 시스템 명령어 경로를 연결하는 역할을 합니다. OpenLiteSpeed를 사용하는 서버라면 대부분 이 방법으로 lsphp 명령어 오류가 해결됩니다.

이미지 확인 후 적용한 내용

Ubuntu 환경에서 심볼릭 링크를 통해 실행 파일 경로를 연결하는 구조 — Ubuntu 서버에서 심볼릭 링크 생성 구조를 설명하는 예시

심볼릭 링크는 원본 파일을 복사하는 방식이 아니라 연결만 생성합니다.

따라서 실제 PHP 실행 파일은 그대로 유지하면서 시스템 어디에서든 lsphp 명령어를 사용할 수 있게 됩니다.

OpenLiteSpeed 재시작 후 테스트

링크 생성이 끝난 뒤 OpenLiteSpeed 서비스를 다시 불러왔습니다.

sudo /usr/local/lsws/bin/lswsctrl restart

이후 다시 PHP 버전을 확인했습니다.

lsphp -v

이번에는 정상적으로 PHP 버전 정보가 출력되었습니다.

서버를 재부팅하지 않아도 바로 반영되었으며 SSH 세션을 새로 열어도 동일하게 작동했습니다.

적용 후 달라진 점

이번 lsphp 명령어 오류는 PHP 설치 문제가 아니라 경로 연결 문제였습니다.

패키지를 다시 설치하거나 OpenLiteSpeed를 재설치할 필요는 없었습니다.

심볼릭 링크를 생성한 뒤에는 다음과 같은 변화가 있었습니다.

PHP 버전 확인 정상화
SSH 명령어 인식 문제 해결
서버 관리 명령어 사용 가능
OpenLiteSpeed 유지보수 편의성 향상

특히 여러 PHP 버전을 운영하는 환경에서는 lsphp 경로가 바뀌는 경우도 있기 때문에 서버 업그레이드 이후 다시 확인해 보는 것이 좋습니다.

FAQ

lsphp 명령어 오류가 발생하면 PHP를 재설치해야 하나요?

대부분은 아닙니다. PHP가 정상 작동하고 있다면 심볼릭 링크 또는 PATH 설정 문제인 경우가 많습니다.

lsphp 경로는 항상 lsphp82인가요?

아닙니다. PHP 8.3은 lsphp83, PHP 8.4는 lsphp84 형태로 달라질 수 있습니다.

OpenLiteSpeed에서만 lsphp 명령어를 사용하나요?

주로 OpenLiteSpeed 환경에서 사용됩니다. 일반 Ubuntu PHP 패키지 환경에서는 php 명령어를 사용하는 경우가 많습니다.