Purchaser は、舟券を自動購入するための PHP ライブラリです。
composer require bvp/purchaserensureBalance() は投票せず、残高を指定額まで満たすだけのメソッドです。
「入金する」ではなく「この額まで満たす」形なので、何度呼んでも結果が同じになります
（catch-up で二重に走っても積み増しません）。
<?php
require __DIR__ . '/vendor/autoload.php';
use BVP\Purchaser\Purchaser;
$balance = Purchaser::setSubscriberNumber('xxxxxxxx') // 加入者番号
->setPersonalIdentificationNumber('xxxx') // 暗証番号
->setAuthenticationPassword('xxxxxx') // 認証用パスワード
->setPurchasePassword('xxxxxx') // 投票用パスワード
->setArtifactDirectory(__DIR__ . '/storage/purchaser') // 失敗時の画面を保存する
->ensureBalance(); // 既定 10,000 円まで満たす内部の手順は次の4段で、入金エラーを発生させないために最後の再照会まで必ず通します。
- 必要額を確定する
- 残高照会
- 不足していれば、不足分を 1,000 円単位に切り上げて入金
- 残高照会で必要額を満たしたことを確認（入金の反映は非同期）
残高が既に足りていれば手順3を飛ばします。このとき手順2の照会が手順4の確認を兼ねます。
締切直前の投票からこの往復を外せるので、朝に1回呼んでおくのが基本の運用です。 あわせて、ログイン・投票ウィンドウの生成・お知らせダイアログ・残高照会の DOM を お金を動かさずに通るので、サイト改修の日次カナリアにもなります。
<?php
require __DIR__ . '/vendor/autoload.php';
use BVP\Purchaser\Purchaser;
// type: 単勝 => 1, 複勝 => 2, 2連単 => 3, 2連複 => 4, 拡連複 => 5, 3連単 => 6, 3連複 => 7
$receipt = Purchaser::setSubscriberNumber('xxxxxxxx')
->setPersonalIdentificationNumber('xxxx')
->setAuthenticationPassword('xxxxxx')
->setPurchasePassword('xxxxxx')
->setArtifactDirectory(__DIR__ . '/storage/purchaser')
->setMaxTotalAmount(10000) // 1レースの購入金額合計の上限
->setDeadline(new DateTimeImmutable('2026-08-08 15:32:00')) // 締切時刻
->purchase(stadiumNumber: 24, number: 12, type: 6, focuses: [
'1-2-3' => 100, // 組番 => 購入金額
'1-2-4' => 100,
'1-3-2' => 100,
'1-3-4' => 100,
]);
echo $receipt->totalAmount; // 400
echo $receipt->elapsedMilliseconds; // 所要時間（締切何分前まで詰められるかの実測に使う）
print_r($receipt->stepMilliseconds);purchase() は投票の前に ensureBalance() を通すので、残高が足りなければその場でも入金します。
朝に満たしてあれば照会1回で素通りします。
戻り値の Receipt に何をいくら買ったかが入るので、そのまま購入履歴に残せます。
| メソッド | 既定 | 役割 |
|---|---|---|
setMaxTotalAmount() |
10,000 円 | 1レースの購入金額合計の上限。呼び出し側のバグを止める |
setMaxDepositAmount() |
10,000 円 | 1回の入金指示の上限。想定外の巨額入金を止める |
setDeadline() |
なし | 締切間際になったら投票せずに中止する |
setArtifactDirectory() |
なし | 失敗時にスクリーンショットと HTML を保存する |
setLockPath() |
/tmp/bvp-purchaser.lock |
朝の入金・締切前の投票・手動ログインを排他する |
買い目・金額の検証（組番の要素数、艇番の範囲、100 円単位、重複）は ブラウザを起動する前に済ませるので、直せない入力はテレボートに触る前に落ちます。
このリポジトリをクローンします。
git clone git@github.com:boatracevibeproject/purchaser.git必要なライブラリをインストールします。
cd purchaser && composer install加入者番号、暗証番号、認証用パスワード、投票用パスワード、買い目をそれぞれ書き換えます。
code example.phpGoogle Chrome の Selenium Grid Server を起動します。
docker run -d -p 4444:4444 --shm-size="2g" --name selenium-standalone-chrome selenium/standalone-chrome:4.2.2-20220622購入プログラムを実行します。
php example.php買い目の解釈・入金額の計算・ロックは Selenium も会員情報も無しで実行できます。
vendor/bin/phpunitテレボートへ実際に接続する結合テストは、段階ごとに別の環境変数でオプトインします （既定では全てスキップされます）。
| 環境変数 | 範囲 |
|---|---|
PURCHASER_E2E=1 |
ログインと残高照会のみ（お金は動かない） |
PURCHASER_E2E_DEPOSIT=1 |
入金まで行う（お金が動く） |
PURCHASER_E2E_PURCHASE=1 |
実際に舟券を買う（お金が減る） |
会員情報を環境変数に設定します。
$env:SUBSCRIBER_NUMBER = "加入者番号"
$env:PERSONAL_IDENTIFICATION_NUMBER = "暗証番号"
$env:AUTHENTICATION_PASSWORD = "認証用パスワード"
$env:PURCHASE_PASSWORD = "投票用パスワード"Selenium Server を起動します。
npm install selenium-standalone --save-dev
npx selenium-standalone install
npx selenium-standalone startこのライブラリを使用して舟券を自動購入する際には、以下の点に十分ご注意ください。
- 自己責任
本ライブラリを使用した結果として発生した如何なる損害（経済的損失、データ損失、法的問題など）についても、作者および貢献者は一切の責任を負いません。すべてのリスクは利用者自身が負うものとします。
- 法的遵守
舟券の購入や自動化に関する法規制は国や地域によって異なる場合があります。本ライブラリを使用する前に、必ずご自身の居住地域における関連法規を確認してください。不適切または違法な使用について、作者は一切の責任を負いません。
- 利用上のリスク
公営競技の投票システムやAPI仕様の変更、技術的トラブル、予期せぬ動作による購入エラーが発生する可能性があります。これらによって生じた損失について、作者は責任を負いません。
- 本ライブラリをテスト環境や小額で検証してから使用してください。
- ソースコードを理解した上で、責任を持って運用してください。
- ご不明点がある場合は、必ず専門家に相談してください。
Purchaser は MIT license の元で公開されています。