安裝 PhpMyAdmin

No Comments

筆者試了兩種安裝方式,其主要目的都是因為 Ubuntu 提供的 phpmyadmin 預設下會安裝 Apache2。但我又不希望 Caddy 與 Apache2 會造成衝突,所以才有本文所述繞路的做法;避免安裝了 Apache2。

使用 Ubuntu 預設的 phpmyadmin 套件

sudo apt install –no-install-recommends phpmyadmin(注意雙 dash)

會出現如下視窗,按 ESC 跳過

出現以下視窗,是為了設定 phpmyadmin 自己所用的帳號及資料庫:
若使用者目前的 MariaDB root password 是空的,那麼可以選擇是;否則選擇否,按 ENTER 繼續。

接著,至 /etc/phpmyadmin,編輯 config.inc.php,如圖拿掉 // 註解,並將 cookie 改成 http ,存檔離開

接著,將路徑切換到 /usr/share/phpmyadmin 下,並執行 du -h 查看目錄下的檔案空間佔用狀況,筆者的是 26MB

開始之前請注意,若 MariaDB root password 還是空的話,此時就要先去建立密碼了。故再執行一次 mysql_secure_installation 即成。

首先我們先用 PHP 內建的 web server 測試 phpmyadmin 。在 /usr/share/phpmyadmin 下,執行:

php -S localhost:2019

接著就可以打開瀏覧器輸入 http://localhost:2019 會出現 密碼登入,鍵入在 MariaDB 中所建立的 root 登入帳密。即可進入管理畫面了。

在主頁,拉到下,會有如圖的提示訊息(當 phpmyadmin 的資料庫尚未建立時):尚未設定 phpMyAdmin 設定儲存空間,部份延伸功能將無法使用。 了解原因。點擊 “了解原因”

再點擊 建立,即會自動建立 phpmyadmin 給它自己使用的資料庫,名稱 phpmyadmin。接著登出。

此外,查看 php web server 所回報的 phpmyadmin 的錯誤訊息,有三條…暫先忽略,因為 phpmyadmin 對於資料庫的存取當前若都正常的話,或者我們只要能設定 wordpress 能正常存取資料庫,何妨。按 Ctrl-c 終止 php webserver

網頁根路徑與權限的基礎設定

因為 Apache2 使用了 /var/www/html 做為網頁的根路徑。利於除錯及區分起見,筆者設定根路徑為 /var/web 且 按慣例,所有不同用途的網頁都置於此,或由此連結出去,統一管理。

也不知是哪個套件所設定出來的,我們按慣例延用已存在的 user = www-data,group = www-data 來做為網頁的存取者。

首先建立 /var/web 目錄,並設定權限。也將 phpmyadmin 連結至該處:

  • sudo mkdir /var/web
  • 修改 /var/web 的擁有者成 www-data
  • sudo chown www-data:root /var/web
  • 修改 www-data 使用者的家目錄 /var/www 成 /var/web。可先 cat /etc/passwd | grep www-data 來查看
  • sudo usermod -m -d /var/web www-data
  • cd /var/web
  • 此路徑下,再建立 phpmyadmin 的連結 dbadmin
  • sudo ln -s /usr/share/phpmyadmin dbadmin
  • 變更 phpmyadmin 的擁有者
  • sudo chown -RL root:www-data dbadmin

接者,至 /etc/php/7.3/cli 編輯 php.ini,在 doc_root = 加上參數值 /var/web,是設定了網頁的根目錄路徑。順便更改其他二項都成 512M。存檔離開。

  • doc_root = /var/web
  • post_max_size = 512M
  • upload_max_filesize = 512M

使用 Composer 安裝 phpmyadmin 套件

Composer 是 PHP 的套件相依性管理工具,且也已成主流,所以安裝它並無不妥。再由它來安裝 phpmyadmin。

Composer

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"


php -r "if (hash_file('sha384', 'composer-setup.php') === 'a5c698ffe4b8e849a443b120cd5ba38043260d5c4023dbf93e1558871f1f07f58274fc6f4c93bcfd858c6bd0775cd8d1') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"


php composer-setup.php


php -r "unlink('composer-setup.php');"

請注意上段的指令請直接至 https://getcomposer.org/download/ 該處複製下來執行,因為檔案一直在更新,簽名碼當然也會不同。

接著將執行檔移至 /usr/local/bin 則可全域執行。

sudo mv composer.phar /usr/local/bin/composer

網頁路徑與權限設定

接續之前,我們在這個時間點一樣先做些前置作業,請參考本文上半段,類似這個段落的完整說明:

  • sudo mkdir /var/web
  • 修改 /var/web 的擁有者成 www-data
  • sudo chown www-data:root /var/web
  • 修改 www-data 使用者的家目錄 /var/www 成 /var/web。可先 cat /etc/passwd | grep www-data 來查看
  • sudo usermod -m -d /var/web www-data
    可能會有錯誤訊息,忽略之。再 grep 一次確認。又或 www-data 已被行程佔用則先暫終止之。
  • php.ini:doc_root = /var/web,post_max_size = 512M,upload_max_filesize = 512M

PhpMyAdmin

接著,至 PhpMyAdmin 官網查看執行安裝的命令。

使用 composer 有一點要注意的是,官方建議避免使用 root 權限來使用它。因此,使用它,偶爾要繞點路。

  • sudo mkdir /var/web/phpmyadmin
  • $ME 改成您的使用者名稱,例如,筆者用 kenny
  • sudo chown $ME:$ME /var/web/phpmyadmin
    請注意,
    我們就是將 ./phpmyadmin 底下的所有檔案的擁有權設給管理者了。
    故執行 composer 的最高權限者就是管理者。不要/用再加 sudo 了。
    而後面敍述中,會將該目錄下的檔案 chown 成 root:www-data。
    原則上,暫先不更動維持 $ME:$ME,若無法正常使用,再去嘗試改擁有者。
    並且,已知的問題是,./tmp 的存取問題。試想我們之後會將它設為 www-data:www-data,那麼存取上是沒有問題的,但,新産生的檔案,擁有者將是 $ME,故,在 phpmyadmin 主控台中,仍會出現該提示問題。反之,若我們將該目錄設為 $ME:$ME,則同樣 www-data 將無法存取該目錄。故可行但絕不能妥協的方法是,使用 $ME:$ME 並將 www-data 納入 $ME 群組中。
  • 接著就是安裝了。下列中,第一個phpmyadmin是指套件提供者,第二個phpmyadmin是指套件名稱,第三個是安裝目的路徑
  • composer create-project phpmyadmin/phpmyadmin /var/web/phpmyadmin
  • 安裝過程中,會出現錯誤或警告訊息,這是因為筆者並未安裝 apache2及伴隨的副套件,所以所缺者,我們須一一補安裝。

當安裝結束後,我們第一步要做的,就是查看安裝目的地,是否有建立 composer.json 檔案,若沒有,則安裝指令可以重覆使用;若有,則不能再使用安裝指令了,而是須使用更新指令。故,另開一個終端,查看該路徑。結果有它,便進入該目錄 cd /var/web/phpmyadmin

接著再回來看錯誤訊息:

第一個是 lock file 要更新,故:
composer update --lock

執行結果,lock file 更新後,問題也從原先的 6 個減成 3 個。這些問題,都是因為缺少了 PHP的相關套件,故我們可以如此查找:apt list | grep php7.3

果然有看到跟問題類似的套件,二話不說,連同看順眼的套件一併安裝:sudo apt install php7.3-bz2 php7.3-curl php7.3-fpm php7.3-mbstring php7.3-mysql php7.3-xml php7.3-zip

因為 php7.3-fpm 是網頁快取的必要套件,安裝後,如同前文 cli 路徑下的 php.ini 做設定:doc_root = /var/web(有反而錯,很重要,不要去設定),post_max_size = 512M,upload_max_filesize = 512M

  • cd /etc/php/7.3/fpm
  • sudo gedit php.ini
  • sudo systemctl restart php7.3-fpm

再回到 /var/web/phpmyadmin 路徑下執行:composer update
這一步是執行此套件的更新。
另外有 lock file 也需要更新,composer update –lock(注意是 – -lock)
而若出現錯誤訊息,就是有相依套件沒有安裝或是舊版的,需要更新,如下一步,
composer update –with-all-dependencies(注意是 – -w)。
若是再也沒有任何錯誤訊息出現就是成功完成安裝此套件了。

結果,沒有錯誤訊息了而且也開始安裝了;其主要行為是在子目錄 ./vendor 下安裝 phpmyadmin相關的套件。下圖是安裝成功後的最後提示。

接下來,類似並請參考前半段,要設定 phpmyadmin 的組態檔,在該目錄下:

  • cp config.sample.inc.php config.inc.php
  • gedit config.inc.php
  • 建立捷徑
  • cd /var/web
  • sudo ln -s /var/web/phpmyadmin dbadmin
  • 變更擁有者
  • sudo chown -RL root:www-data ./dbadmin
  • 最後,使用 php web server 做測試

我們看到有二個問題,第一個如前半段所述。第二個問題是因為筆者把權限設定得比較嚴格,故修正:

  • cd /var/web/phpmyadmin
  • sudo mkdir tmp
  • sudo chown -R www-data:www-data ./tmp(注意,root:www-data or www-data:root 都不行)
  • sudo chmod -R 777 ./tmp

結論

  • 選擇:第二種安裝方式,使得 php web server 並沒有回報任何問題,不過 du -h 查看,使用了 158MB 的磁碟空間。故本文所述的兩種安裝,就看您的取決了。
  • 補充:使用 VirtualBox,筆者就能在安裝 phpmyadmin 之前,備份出來虛擬磁碟,再複製一個出來跑 Ubuntu 提供的,出來另一個跑 Composer 的方式,如此,例如筆者用 Ubuntu 提供的,砍掉重練三四次了相當便捷。
  • 最後,因為筆者的架站特色就是使用個人筆電,適用於同時間參訪人數不會很多的情況。因此,在這樣的伺服器上就是盡量少使用資源少安裝一些哩哩叩叩的程式。
    在接下來的安裝所需,於本文未提及的,現在需加裝:(因若某套件重覆安裝的話,apt 會設定成手動安裝僅而影響紀錄,故我們區分開來)
  • 本文第一種安裝方式需加裝:sudo apt install curl net-tools php7.3-fpm,並且設定 php.ini 如第二種方式所述。
  • 本文第二種安裝方式需加裝:sudo apt install curl net-tools

範例:為 wordpress 配置資料庫

就筆者目前已知(以下純個人觀點),wordpress 是由外觀主題與控制框架, 頁,文章,及資料庫這幾種元件庫所構成的。頁與文章可說是相同的東西(甚至也可歸類入第一種),且因所謂抽離化的設計,所有網頁設計者所加入的文字或內容,都納入後端資料庫中,而由後端網頁的程式碼框架來對應呼叫引用,來呈現前端訪客所看到存取到的內容。因此 wordpress 資料庫是最重要的,存放著網頁設計者的心血。
為 wordpress 配置,只需三樣資料:資料庫名稱,其使用者及其密碼。我們分別取 MYWPADMINMYWPADMINMYWPPW 來做為例子。以下按圖操課即可。最後,須變更預設字集成 utf8:ALTER DATABASE MYWPADMIN CHARACTER SET utf8 COLLATE utf8_general_ci;
20221126 更新,字集的部份應是不用修改直接使用預設 utf8mb4_generic_ci 即可,參考如下。而 wordpress 的組態檔的字集欄位一樣使用預設而不用更動。
https://stackoverflow.com/questions/6115612/how-to-convert-an-entire-mysql-database-characterset-and-collation-to-utf-8

請注意,GRANT 預設是不勾選的。早期筆者勾選,wordpress 發生的某問題/忘了,才得以解決。但後期,筆者嘗試不勾選它,仍可正常運作。故,應是該再三確認此處的設定,請自行谷歌。

Categories: Linux 架設網站

Tags: ,

PHP Code Snippets Powered By : XYZScripts.com