PHP Serial

PHP でマイコンとシリアル通信するクロスプラットフォームライブラリ。

概要

PySerial や Ruby serialport のような使い勝手を提供。 Windows、Mac、Linux で動作し、Pure PHP 実装。

動作環境

• PHP 8.1 以上
• Windows、Linux、macOS

PHP 本体のセキュリティ修正が提供されているバージョン（サポート対象）で、最新のパッチリリースを使うことを推奨します。

インストール

Composer を使用してインストール:

composer require tomio2480/php-serial

特定のバージョンを指定する場合:

composer require tomio2480/php-serial:^1.3

基本的な使い方

<?php

require 'vendor/autoload.php';

use PhpSerial\Configuration;
use PhpSerial\SerialPort;

$config = new Configuration(
    baudRate: 9600,
    dataBits: 8,
    parity: Configuration::PARITY_NONE,
    stopBits: Configuration::STOP_BITS_1
);

$port = new SerialPort('/dev/ttyUSB0', $config);
$port->open();

// データ送信
$port->write("Hello, Arduino!\n");

// データ受信
$response = $port->readLine(timeout: 2000);
echo "Received: {$response}\n";

$port->close();

read(int $length = 1024) は最大 $length バイトを返します。 1 回で確保するバッファの上限は 64 KiB で、上限を超える指定は上限へ丸めます。 1 未満を指定すると RuntimeException を送出します。

設定例

ボーレート

対応するボーレート（bps）は次のとおりです。

110, 300, 600, 1200, 2400, 4800, 9600, 14400, 19200, 38400, 57600, 115200, 230400

$config = new Configuration(baudRate: 115200);

パリティ

use PhpSerial\Configuration;

// パリティなし
$config = new Configuration(parity: Configuration::PARITY_NONE);

// 奇数パリティ
$config = new Configuration(parity: Configuration::PARITY_ODD);

// 偶数パリティ
$config = new Configuration(parity: Configuration::PARITY_EVEN);

データビット

対応: 5, 6, 7, 8

$config = new Configuration(dataBits: 8);

ストップビット

use PhpSerial\Configuration;

$config = new Configuration(stopBits: Configuration::STOP_BITS_1);
// または
$config = new Configuration(stopBits: Configuration::STOP_BITS_2);

メソッドチェーン

$config = new Configuration();
$config
    ->setBaudRate(115200)
    ->setDataBits(8)
    ->setParity(Configuration::PARITY_NONE)
    ->setStopBits(Configuration::STOP_BITS_1);

デバイスパス

Windows

$port = new SerialPort('COM3');

重要: Windows 環境では PHP FFI 拡張の有効化を強く推奨します。

正確で安定したシリアル通信を実現するため、php.ini で FFI を有効にしてください：

extension=ffi
ffi.enable=true

FFI 無効時はフォールバック実装が使用されますが、データ受信が動作せず送信のみ可能となります。 詳細は docs/WINDOWS_FFI_SETUP.md を参照してください。

Linux

$port = new SerialPort('/dev/ttyUSB0');
// または
$port = new SerialPort('/dev/ttyACM0');

macOS

$port = new SerialPort('/dev/tty.usbserial');

テスト

環境変数でテスト用デバイスを指定:

# .env.exampleを.envにコピー
cp .env.example .env

# .envファイルでTEST_SERIAL_PORTを設定
# TEST_SERIAL_PORT=COM3

# テスト実行
composer test

使用例

基本的な使用例は examples/basic.php を参照。 複数コマンド送信の例は examples/advanced.php を参照。

開発

品質確認

すべての品質チェックを一度に実行:

composer qa

個別チェック:

composer cs:check      # PSR-12準拠チェック
composer cs:fixer      # コードスタイルチェック
composer stan          # PHPStan静的解析 (レベル8)
composer test          # テスト実行

詳細は CONTRIBUTING.md を参照してください。

ライセンス

MIT