PHPMyAdmin 외부 접속 오류 및 수동 설치하기

PHPMyAdmin 접속 오류

 

이전 글을 보면서 PHPMyAdmin 설치를 잘 하여 localhost/phpmyadmin은 잘 접속이 되지만, 도메인/phpmyadmin이나 도메인/phpmyadmin/index.php을 입력하면 아예 접속조차 되지 않는 경우가 있다.
이럴 때 보통 http error 500 phpmyadmin 에러를 나타내거나 다른 접속할 수 없다는 오류 페이지를 나타낸다.
나는 이를 해결하기 위해 3일 동안 밤새가며 이유가 뭔지 찾기 시작했고,
구글링을 하며 많은 해결 방법들을 실행해봐도 똑같은 오류 메시지가 나타났다.
3일 동안 밤새며 많은 시도 끝에 해결할 수 있었는데,
그 방법은 PHP와 PHPMyAdmin간의 버전 호환성을 맞춰주는 것이다.

 

 

$ sudo php -v

PHP 버전은 뒤에 8을 제외한 PHP8.0으로 통용됩니다

먼저 저는 PHP가 7.2버전이었을 때는 PHPMyAdmin이 실행이 잘 됐지만 PHP8.0으로 업데이트한 후 부터 접속이 되지 않았습니다. 그래서 저는 PHP 버전을 확인했습니다.

 

 

 

PHPMyAdmin 삭제

 

$ sudo apt-get purge phpmyadmin

PHPMyAdmin을 삭제해줍니다. 이후에 $ sudo apt autoremove --purge를 해주셔도 되지만 이는 PHP8.0도 같이 지워버리게 때문에 저는 따로 안해주었습니다. 또한 삭제 방법으로 remove와 purge 두 방법이 있는데 remove는 환경 설정 파일을 남기는 반면 purge는 환경 설정 파일까지 삭제해줍니다.

 

$ sudo rm -r /var/www/html/phpmyadmin

 

또한 심볼릭 링크를 걸어주었던 경로를 찾아가 심볼릭 링크 파일을 지워줍니다.

 

 

PHPMyAdmin 수동 설치

 

이전 글에서는 $ sudo apt install phpmyadmin을 해주었지만 이는 최신 버전이 아닌 구버전이 자동으로 깔리게 되고, 다시 설치해도 같은 오류가 발생할 것이기 때문에 저희는 PHPMyAdmin 수동설치를 해주도록 하겠습니다.

$ sudo wget -P ~/다운로드 https://files.phpmyadmin.net/phpMyAdmin/5.1.1/phpMyAdmin-5.1.1-all-languages.tar.gz

저장된 경로

다운을 받았으면 저장된 경로로 가서 압축을 풀고 파일을 /usr/share로 이동해줍니다. 

$ sudo tar -xzf /home/ubuntu/다운로드/phpMyAdmin-5.1.1-all-languages.tar.gz -C /usr/share

 

 

이동시켜준 파일의 이름을 phpmyadmin으로 바꾸고 심볼릭 링크를 걸어주고 nginx를 재시작 해줍니다.

$ sudo mv /usr/share/phpMyAdmin-5.1.1-all-languages /usr/share/phpmyadmin
$ sudo ln -s /usr/share/phpmyadmin /var/www/html/phpmyadmin
$ sudo service nginx restart

 

 

이후 도메인/phpmyadmin 또는 도메인/phpmyadmin/index.php를 입력해서 접속해주면 됩니다

잘 접속되는 모습