語法筆記 on Tom 除錯中

PHP 物件導向語法筆記

Mon, 24 Apr 2023 17:50:21 +0800

參考 PHP 官方文件，沒看過、記不起來，或覺得有必要的才在這裡寫筆記。

Properties

class 中的變數，至少要有一個修飾詞 Visibility、 Static Keyword 或是 readonly (PHP 8.1.0 以上)。宣告時的初始值必須是常數(基本型別或 constant )，表示必須在編譯時期確定其值，而不是在 runtime 時。沒有 Visibility 的屬性，預設是 public，所以 static $var = 1 ，則此屬性預設是 public

PHP 7.4.0 開始，可以有 Type declarations 的屬性，必須在存取前初始化，否則會丟出 Error ，不會自動給預設值 0, 0.0F, 或空字串。沒有 Type declarations 的屬性 ( 例如 public $var)，則會給預設值 null

Class Constants

一個類別建立一個 class constant，不是一個物件建立一個。

<?php
class A
{
 const C = 'C';

 public function getConstant() {
 return self::C;
 }
}

class constant C 只有一個，歸屬於類別 A，即使是 new 三個物件 A，分給變數 $a1, $a2 和 $a3，也只有一個 class constant C，所以使用 $a1::C 存取，不是 $a1->C，在內部存取是用 self::C，不過用 $this->C 也可以，但是那樣的話用 $a1->getConstant() 會產生錯誤。總之，把 class constant 當做 static final 變數來使用

PostgreSQL 筆記

Mon, 24 Apr 2023 17:50:21 +0800

之前都在用 MySQL，好奇隔壁棚的 PostgreSQL 有什麼不一樣，所以想玩玩看。講 PostgreSQL 的書相比 MySQL 很少，幸運的是最近發現一本「SQL 語法查詢入門」，使用的是 PostgreSQL，所以以下是這本書的筆記。

資料庫、資料表和資料欄名稱如果要用引號，必須用雙引號，資料欄的值如果要用引號，必須用單引號。

新增和管理資料庫

在 Linux 執行以下指令，用 PostgreSQL 預設的管理員帳號執行 psql 管理程式

sudo -u postgres psql

新增使用者和資料庫，並設定權限

-- 新增使用者，同時設定密碼
CREATE USER 使用者名稱 WITH PASSWORD '密碼';
-- 新增使用者和擁有者
CREATE DATABASE 資料庫名稱 OWNER 使用者名稱;
-- 設定使用者對資料庫有完整權限
GRANT ALL PRIVILEGES ON DATABASE 資料庫名稱 to 使用者名稱;

psql

# 測試使用者能否登入
psql -U 使用者名稱 -d 資料庫名稱 -h 127.0.0.1
# 使用指定的資料庫和使用者執行 test.sql 儲存的 SQL，然後離開 psql
psql -U 使用者名稱 -d 資料庫名稱 -h 127.0.0.1 -f test.sql
# 顯示 psql 所有指令
\?
# 更改連線的資料庫、使用者
\c[onnect] 資料庫名稱 使用者名稱
# 離開 psql
\q

SELECT 子句執行順序

SELECT 欄位清單
FROM 資料表
WHERE 條件式
GROUP BY 條件式
HAVING 條件式
ORDER BY 條件式

FROM 產生資料集合
WHERE 過濾 FROM 產生的集合
GROUP BY 彙整 WHERE 過濾後的集合
HAVING 過濾 GROUP BY 彙整的集合
SELECT 轉換過濾與彙集過的集合（通常是透過彙整函式）
ORDER BY 排序 SELECT 轉換後的集合

(上述順序和說明來自 Effective SQL 中文版 P. 122，有稍加修改)

使用 API Blueprint 寫文件

Mon, 24 Apr 2023 17:50:21 +0800

API Blueprint 是一種 markdown 語法的擴充，用來寫 RESTful API 文件

工具

API Blueprint 官網有列出許多工具，推薦網站Apiary。免費註冊後就能在線上編輯文件，左右對照 Markdown 和預覽結果，對於屬性有完整支援。

Aglio 則用來把 Markdown 轉成 HTML，安裝與使用方法如下：

# 在 Debian 11 上安裝

# 先安裝 Node.js
sudo apt install curl build-essential
curl -sL https://deb.nodesource.com/setup_16.x | sudo bash -
sudo apt install nodejs

node -v
npm -v

# 使用 npm 全域安裝
sudo npm install -g aglio

# 也可以用 yarn 安裝
# 安裝 yarn
sudo apt install curl gnupg
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt-get update
sudo apt-get install yarn
yarn --version

# 使用 yarn 全域安裝
sudo yarn global add aglio

接著編輯好 markdown 檔案，例如 example.md，然後執行 aglio -i example.md -o example.html ，轉換成 example.html。可以執行 aglio 指令看看參數有哪些。可以使用 aglio -i example.md -s -h 0.0.0.0 -p 8000 產生即時預覽。