【PHP8.x】CURLWS_RAW_MODE定数の使い方
CURLWS_RAW_MODE定数の使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
CURLWS_RAW_MODE定数は、PHPのcURL拡張機能において、WebSocket通信時のデータ処理モードを指定するために使用される定数です。この定数は、CURLOPT_WS_OPTIONSオプションに設定することで、cURLライブラリがWebSocketのデータフレームをどのように扱うかを制御します。具体的には、この定数を指定すると、cURLはWebSocketのメッセージペイロード（送受信される実際のデータ部分）に対して、通常自動的に行われるエンコードやデコードの処理を行いません。
これにより、アプリケーション開発者は、WebSocketフレーム内の生データに直接アクセスし、独自のデータ形式やプロトコルに従ったエンコード・デコード処理を自分自身で実装することが可能になります。例えば、標準的なテキストデータやバイナリデータではなく、特定のカスタムバイナリフォーマットや暗号化されたデータをWebSocket経由でやり取りする際に、この生データモードが非常に有効です。PHP 8以降のcURL拡張で利用でき、より低レベルでのWebSocket通信の制御が必要な場合に、柔軟なデータハンドリングを実現します。この定数は、高度なWebSocketアプリケーションを構築する際に、開発者に大きな自由度を提供します。
構文(syntax)
1<?php 2$option_flag = CURLWS_RAW_MODE; 3?>
引数(parameters)
引数なし
引数はありません
戻り値(return)
戻り値なし
戻り値はありません