(PHP 4, PHP 5, PHP 7, PHP 8)
addcslashes — C 言語と同様にスラッシュで文字列をクォートする
characters
パラメータに羅列された文字の前にバックスラッシュを付けた文字列を返します。
stringエスケープしたい文字列。
characters
エスケープの対象となる文字を並べたもの。
characters
が \n, \r 等の文字を含んでいる場合、
C言語と同様の手法によりエスケープされます。
アスキーコードが32未満または126より大きい文字は、8進表現に変換されます。
characters 引数の文字の列びを定義する際には、
範囲の最初と最後で指定する文字集合に含まれる文字の種類を把握するようにしてください。
例1 範囲指定で addcslashes() を使う
<?php
echo addcslashes('foo[ ]', 'A..z');
// 出力: \f\o\o\[ \]
// 全ての大文字と小文字はエスケープされます。
// ... しかし、[\]^_` もエスケープされてしまいます。
?>例2 誤った文字の順番を addcslashes() に指定する
<?php
echo addcslashes("zoo['.']", 'z..A');
// 出力: \zoo['\.']
?>
0, a, b, f, n, r, t そして v といった文字をエスケープするときには注意しましょう。
変換結果はそれぞれ 0,円 \a, \b, \f, \n, \r, \t そして \v となりますが、
これらはすべて、C 言語では定義済みのエスケープシーケンスです。
その多くは C 言語に由来する他の言語でもエスケープシーケンスとして定義されており、
PHP も例外ではありません。つまり、characters にこれらの文字を定義した状態で
addcslashes() を使って他の言語のコードを生成したときに、
期待通りの結果が得られない可能性があるということです。
エスケープされた文字列を返します。
"0円..37円" のように characters
に範囲を指定可能です。この場合、アスキーコードが 0 から 31
の範囲の文字は全てエスケープされます。
例3 addcslashes() の例
<?php
$not_escaped = "PHP isThirty\nYears Old!\tYay to the Elephant!\n";
$escaped = addcslashes($not_escaped, "0円..37円!@177円..377円");
echo $escaped;
?>
If you are using addcslashes() to encode text which is to later be decoded back to it's original form, you MUST specify the backslash (\) character in charlist!
Example:
<?php
$originaltext = 'This text does NOT contain \\n a new-line!';
$encoded = addcslashes($originaltext, '\\');
$decoded = stripcslashes($encoded);
//$decoded now contains a copy of $originaltext with perfect integrity
echo $decoded; //Display the sentence with it's literal \n intact
?>
If the '\\' was not specified in addcslashes(), any literal \n (or other C-style special character) sequences in $originaltext would pass through un-encoded, but then be decoded into control characters by stripcslashes() and the data would lose it's integrity through the encode-decode transaction.addcslashes() treats NUL as a string terminator:
assert("any" === addcslashes("any0円body", "-"));
unless you order it backslashified:
assert("any\000円body" === addcslashes("any0円body", "0円"));
(Uncertain whether this should be declared a bug or simply that addcslashes() is not binary-safe, whatever that means.)I have found the following to be much more appropriate code example:
<?php
$escaped = addcslashes($not_escaped, "0円..37円!@\@177円..377円");
?>
This will protect original, innocent backslashes from stripcslashes.