본문으로 건너뛰기

PHP

「언어별 가이드」로 돌아가기 · 문서 목록으로

생성되는 것​

<Path>/
  <AccessorName>.php               접근자 — 여기서 나머지를 전부 require합니다
  tables/<Table>Table.php          테이블당 하나
  enums/<Enum>.php                 enum당 하나 (PHP 8.1 backed enum)
  constants/<Set>.php              상수 세트당 하나
  tabbit/TcbReader.php    바이너리 리더 (함께 생성됩니다)
  tabbit/TabbitUpdater.php     데이터 갱신 (WriteUpdater를 켰을 때만)

필요한 것​

항목값
PHP8.1 이상 — enum을 씁니다
확장없음. 기본 빌드로 동작합니다
Composer필요 없습니다. 오토로더 없이 require_once로 엮여 있습니다

recipe 설정​

"Targets": [
  {
    "Type": "php",
    "Path": "src/GameData",
    "Namespace": "MyGame\Data",
    "AccessorName": "GameData",
    "BinaryTableFileExtension": ".tcb",
    "WriteUpdater": false,           // CDN에서 데이터를 갱신할 거라면 true
    "Sweep": true,
    "TargetSide": "s"
  }
]

쓰는 법​

접근자 파일 하나만 require하면 나머지는 따라옵니다.

require_once __DIR__ . '/src/GameData/GameData.php';

use MyGame\Data\GameData;

$data = new GameData();
$data->readAll('./data');

$sword = $data->item->findByIndex(1);
if ($sword !== null) {
    // 참조는 로드 후 실제 레코드로 연결됩니다.
    echo $sword->name . ' / ' . $sword->itemCategoryByCategoryId->name;
}

foreach ($data->item->records as $row) { /* ... */ }

확장자는 기본 인자입니다.

$data->readAll('./data', '.bytes');

데이터만 갱신하기 (WriteUpdater)​

recipe에 "WriteUpdater": true를 적으면 tabbit/TabbitUpdater.php가 함께 나옵니다.

CDN이나 버킷에 올려둔 데이터를 받아 로컬 사본을 최신으로 유지하는 코드입니다. 배포를 다시 하지 않고 데이터만 패치하기 위한 것입니다.

기본값이 false인 이유는 네트워크를 쓰는 유일한 생성물이기 때문입니다.

확장은 필요 없고, 설정 하나를 봅니다. 전송은 PHP의 HTTP 스트림 래퍼라 allow_url_fopen이 켜져 있어야 합니다(기본값 On). ext-curl을 쓰지 않은 이유는 그쪽이 항상 컴파일되어 있지 않기 때문입니다 — 처음엔 curl로 썼고, 게이트를 돌린 인터프리터가 Call to undefined function curl_init()가 나왔습니다.

require_once __DIR__ . '/gamedata/tabbit/TabbitUpdater.php';

use Tabbit\TabbitUpdater;
use Tabbit\UpdateOptions;

$options = new UpdateOptions();
$options->log = static fn (string $m) => \error_log($m);

$result = TabbitUpdater::update('https://cdn.example.com/data', './data', $options);

if ($result->succeeded) {
    $data->readAll($result->localPath);
} else {
    // 이전 데이터가 그대로 있습니다. 그것으로 계속해도 됩니다.
    \error_log($result->error);
}

예외를 던지지 않습니다.

네트워크, 디스크, 손상된 파일은 모두 호출한 쪽이 다뤄야 할 상황이지 결함이 아니기 때문입니다.

실패하면 결과의 error에 이유가 들어 있고, 디스크의 이전 데이터는 손대지 않은 상태입니다.

받은 파일은 전부 매니페스트의 MD5와 대조하고, .staging을 거쳐 마지막에 한 번에 옮깁니다.

주의사항​

오토로더가 없습니다. 이 생성물은 Composer를 전제하지 않으므로 각 파일이 자기가 쓰는 것을 require_once합니다 — 테이블 파일은 테이블 리더와 자기 필드가 쓰는 enum을, 접근자는 전부를. 그래서 소비자는 파일 하나만 require하면 됩니다. Composer 프로젝트에 넣어도 충돌하지 않습니다.

bigint는 int입니다. PHP의 int는 64비트 플랫폼에서 64비트입니다. 테이블 리더는 unpack('P')를 쓰지 않는데, 그것이 2^63을 넘으면 float가 되기 때문입니다 — 32비트 두 개로 나눠 조립합니다.

예약어는 이스케이프하지 않습니다. PHP 7.0부터 프로퍼티와 메서드 이름에 예약어를 쓸 수 있습니다. 회귀 스위트가 키워드 이름 필드로 실제 파싱해서 확인합니다.

datetime과 timespan은 int입니다. .NET 틱이 그대로 들어옵니다.

트러블슈팅​

증상원인과 조치
Class "MyGame\Data\GameData" not found접근자 파일을 require하지 않았습니다. 조각 파일 하나만 require해도 나머지는 안 따라옵니다
syntax error, unexpected 'enum'PHP 8.1 미만입니다
bigint 값이 부정확8.0 이하 32비트 빌드일 수 있습니다. 64비트 PHP를 쓰세요
참조가 nullreadAll 대신 테이블 하나만 읽었거나, 시트가 그 셀에 0을 넣었습니다