【PHP8.x】sodium_add関数の使い方

sodium_add関数は、指定された2つのバイト列（バイナリ文字列）をビット単位で加算する関数です。この関数は、主に暗号学的な文脈で利用されることが想定されており、2つの秘密のバイト列を安全に合成する際や、暗号処理におけるカウンター値を操作する際などに役立ちます。

この関数を使用する際、2つの入力文字列は厳密に同じ長さである必要があります。もし入力文字列の長さが異なる場合、関数はエラーを発生させます。内部では、各バイトが対応する位置のバイトと算術的に加算されます。この加算は、結果が1バイトの最大値（255）を超えた場合、その上位ビットが切り捨てられる（モジュロ256の加算として機能する）という特性を持っています。

sodium_add関数は、加算結果を表す新しいバイト列を返します。例えば、ストリーム暗号のノンストップカウンターをインクリメントする際や、秘密鍵の一部を別のデータと結合するような低レベルの暗号プリミティブとして利用されることがあります。この関数は、Lib sodiumライブラリによって提供される機能の一部であり、セキュリティに関連する処理を行うため、その利用方法とセキュリティ上の考慮事項を十分に理解することが重要です。適切な状況で正確に使用することで、セキュアなアプリケーションの構築に貢献します。

Copy
1<?php
2$data1 = random_bytes(32); // 32バイトのランダムなデータを生成
3$data2 = random_bytes(32); // 32バイトのランダムなデータを生成
4
5sodium_add($data1, $data2);
6?>

string &$string1, string $string2

• string $string1: 加算される文字列（参照渡し）
• string $string2: 加算する文字列

void

この関数は、指定された2つのバイナリ文字列を加算した結果を、最初のバイナリ文字列の参照によって直接更新します。戻り値はありません。