本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

將 DynamoDB 工作階段處理常式與AWS SDK for PHP第 3 版搭配使用

DynamoDB 工作階段處理常式是 PHP 的自訂工作階段處理常式，可讓開發人員使用 Amazon DynamoDB 做為工作階段存放區。將 DynamoDB 用於工作階段儲存，可將工作階段移出本機檔案系統並移至共用位置，以減輕分散式 Web 應用程式中工作階段處理所發生的問題。DynamoDB 快速、可擴充、易於設定，並自動處理資料的複寫。

DynamoDB 工作階段處理常式使用該session_set_save_handler()函數將 DynamoDB 作業掛接到 PHP 的原生工作階段函數中，以允許真正的替代。這包括功能的支援 (例如，工作階段鎖定和廢棄項目收集等功能)，這是 PHP 預設工作階段處理器的一部分。

如需有關 DynamoDB 服務的詳細資訊，請參閱 Amazon DynamoDB 首頁。

基本使用

步驟 1：註冊處理程序

首先，將處理常式執行個體化，並進行登錄。

use Aws\DynamoDb\SessionHandler;

$dynamoDb = new Aws\DynamoDb\DynamoDbClient([
    'region'=>'us-east-1'  // Since version 3.277.10 of the SDK, 
]);                        // the 'version' parameter defaults to 'latest'.

$sessionHandler = SessionHandler::fromClient($dynamoDb, [
    'table_name' => 'sessions'
]);

$sessionHandler->register();

步驟 2. 創建一個表來存儲您的會話

您必須先建立資料表來儲存工作階段，然後才能實際地使用工作階段處理常式。您可以使用適用於 Amazon DynamoDB 的AWS主控台，或使用. AWS SDK for PHP

建立此表格時，請使用 ‘id’ 做為主索引鍵的名稱。同時建議您使用 ‘expires’ 屬性來設定存活期屬性，以受益於工作階段的自動廢棄項目集合。

步驟 3. 像平常一樣使用 PHP 會話

工作階段處理器註冊完畢後，若資料表存在，您可以使用 $_SESSION 超全域 (superglobal) 寫入和讀取該工作階段，其方式與您一般對 PHP 預設工作階段處理器執行的作業相同。DynamoDB 工作階段處理常式會封裝並抽象化與 DynamoDB 的互動，讓您只需使用 PHP 的原生工作階段函數和介面即可。

// Start the session
session_start();

// Alter the session data
$_SESSION['user.name'] = 'jeremy';
$_SESSION['user.role'] = 'admin';

// Close the session (optional, but recommended)
session_write_close();

組態

您可以使用下列選項來設定工作階段處理常式的動作。所有選項皆為選用，但務必了解選項的預設值。

若要設定工作階段處理常式，在進行處理常式的執行個體化時，指定設定選項。下列的程式碼提供了範例，其中指定了所有的設定選項。

$sessionHandler = SessionHandler::fromClient($dynamoDb, [
    'table_name'                    => 'sessions',
    'hash_key'                      => 'id',
    'data_attribute'                => 'data',
    'data_attribute_type'           => 'string',
    'session_lifetime'              => 3600,
    'session_lifetime_attribute'    => 'expires',
    'consistent_read'               => true,
    'locking'                       => false,
    'batch_config'                  => [],
    'max_lock_wait_time'            => 10,
    'min_lock_retry_microtime'      => 5000,
    'max_lock_retry_microtime'      => 50000,
]);

定價

除了資料儲存和資料傳輸費用外，與使用 DynamoDB 相關的成本還是根據表格的佈建輸送量容量計算 (請參閱 Amazon DynamoDB 定價詳細資訊)。傳輸量是以寫入容量和讀取容量的單位來測量。Amazon DynamoDB 站首頁說：

讀取容量的單位，代表針對大小為 4 KB 的項目，每秒一次強式一致性讀取 (或是每秒 2 次最終一致讀取)。寫入容量的單位，代表針對大小為 1 KB 的項目，每秒一次寫入。

最後，您的工作階段資料表所需的傳輸量和成本，將會與您所預期的傳輸流量和工作階段大小相關。下表說明針對每個工作階段函數在 DynamoDB 表上執行的讀取和寫入作業量。

工作階段鎖

DynamoDB 工作階段處理常式支援悲觀的工作階段鎖定，以模擬 PHP 預設工作階段處理常式的行為。根據預設，DynamoDB 工作階段處理常式會關閉此功能，因為它可能會成為效能瓶頸並增加成本，尤其是當應用程式在使用 Ajax 要求或 iframe 時存取工作階段時。請先仔細考慮您的應用程式是否需要工作階段鎖定功能，然後再啟用。

若要啟用工作階段鎖定，請在您進行 'locking' 的執行個體化時，將 true 選項設定為 SessionHandler。

$sessionHandler = SessionHandler::fromClient($dynamoDb, [
    'table_name' => 'sessions',
    'locking'    => true,
]);

垃圾回收

使用 ‘expires’ 屬性在 DynamoDB 資料表中設定 TTL 屬性。這會自動對您的工作階段進行廢棄項目收集，您就不需自行手段執行。

或者，DynamoDB 工作階段處理常式支援工作階段記憶體回收，方法是使用一系列Scan和BatchWriteItem作業。由於 Scan 操作運作方式的本質，和需要找出所有過期的工作階段並加以刪除，垃圾收集程序可能會需要用到許多的佈建傳輸量。

因此，我們不支援自動化的垃圾收集。更理想的做法是將垃圾收集作業排定於離峰時間進行，如此當耗用的傳輸量突增時，就不會干擾到其他的應用程式。例如，您可以設定夜間的 cron 工作，來觸發指令碼，以執行垃圾收集作業。此指令碼需要執行類似下列的動作。

$sessionHandler = SessionHandler::fromClient($dynamoDb, [
    'table_name'   => 'sessions',
    'batch_config' => [
        'batch_size' => 25,
        'before' => function ($command) {
            echo "About to delete a batch of expired sessions.\n";
        }
    ]
]);

$sessionHandler->garbageCollect();

您也可以使用 'before' 中的 'batch_config' 選項，來讓垃圾收集程序所執行的 BatchWriteItem 操作產生延遲。這會增加完成記憶體回收所需的時間，但它可以協助您分散 DynamoDB 工作階段處理常式所發出的要求，以協助您在垃圾回收期間保持接近佈建的輸送量容量或接近佈建的輸送量容量。

$sessionHandler = SessionHandler::fromClient($dynamoDb, [
    'table_name'   => 'sessions',
    'batch_config' => [
        'before' => function ($command) {
            $command['@http']['delay'] = 5000;
        }
    ]
]);

$sessionHandler->garbageCollect();

最佳實務

所需的 IAM 許可

若要使用 DynamoDB SessionHhandler，您設定的認證必須具有使用您在上一個步驟中建立的 DynamoDB 表的權限。下列 IAM 政策包含您需要的最低許可。若要使用此政策，請將資源值取代為先前建立之表格的 Amazon 資源名稱 (ARN)。如需建立和附加 IAM 政策的詳細資訊，請參閱 IAM 使用者指南中的管理 IAM 政策。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "dynamodb:GetItem",
        "dynamodb:UpdateItem",
        "dynamodb:DeleteItem",
        "dynamodb:Scan",
        "dynamodb:BatchWriteItem"
      ],
      "Effect": "Allow",
      "Resource": "arn:aws:dynamodb:<region>:<account-id>:table/<table-name>"
    }
  ]
}