الدالة trim() في PHP: حذف المسافات من طرفي النص

تعيد trim($string) النص بعد حذف المسافات البيضاء من بدايته ونهايته: المسافات، وعلامات الجدولة، والأسطر الجديدة، وعلامات رجوع العربة، وبايتات NUL، وعلامات الجدولة العمودية. وتحذفها ltrim() من البداية فقط وrtrim() من النهاية فقط. وتبقى المسافات في الوسط.

<?php
$input = "   Ada Lovelace \n";

var_dump(trim($input));
var_dump(ltrim($input));
var_dump(rtrim($input));

تُظهر مخرجات var_dump() طول كل نتيجة، وهذا يجعل المحارف المحذوفة مرئية. التشذيب أول ما يُفعل مع معظم القيم القادمة من نموذج (كلمات المرور استثناء، انظر آخر الصفحة): المستخدم الذي يكتب ada@example.com مع مسافة ختامية يجب أن يتمكن من تسجيل الدخول مع ذلك.

الصيغة

trim(string $string, string $characters = " \n\r\t\v\0"): string
ltrim(string $string, string $characters = " \n\r\t\v\0"): string
rtrim(string $string, string $characters = " \n\r\t\v\0"): string

تعيد trim() نصًا جديدًا؛ ولا تغيّر المتغير الذي تمرره.

تشذيب محارف محددة

يستبدل الوسيط الثاني القائمة الافتراضية. ويُحذف كل محرف فيه من الطرفين، بأي ترتيب وأي عدد من المرات. وتحدد .. نطاقًا، لذا فإن 'a..z' تعني كل حرف صغير.

<?php
echo trim('***Sale***', '*'), "\n";
echo rtrim('red, green, blue, ', ', '), "\n";   // remove the trailing ", "
echo ltrim('000123', '0'), "\n";                // leading zeros
echo trim('/blog/post/', '/'), "\n";
echo trim('abc123xyz', 'a..z'), "\n";           // every lowercase letter

لمواصلة حذف المسافات البيضاء العادية أيضًا، ضمّنها في القائمة: trim($s, " \n\r\t\v\0/").

الوسيط الثاني مجموعة محارف لا نص

لا تحذف trim() كلمة أو لاحقة. بل تحذف أيًّا من المحارف التي تذكرها، من الطرفين، حتى تصل إلى محرف ليس في القائمة. وهذا يفاجئ من يحاولون حذف امتداد ملف:

<?php
// Looks like "remove .php", but removes the characters . p h from both ends
var_dump(trim('hello.php', '.php'));

// Remove a suffix: check it, then cut it off
$file = 'hello.php';
if (str_ends_with($file, '.php')) {
    $file = substr($file, 0, -strlen('.php'));
}
var_dump($file);

يحذف السطر الأول الحرف h في البداية أيضًا، لأن h في المجموعة. لحذف بادئة أو لاحقة ثابتة، استخدم str_starts_with() أو str_ends_with() مع substr()، أو str_replace() إذا كان النص لا يمكن أن يظهر في مكان آخر.

تشذيب المسافة كاملة العرض (المُدخلات اليابانية)

كثيرًا ما تنتج لوحات المفاتيح اليابانية المسافة الإيديوغرافية 　 (U+3000)، مثلًا حول اسم كُتب في نموذج. ليست في القائمة الافتراضية لـ trim، وذكرها في الوسيط الثاني فخ: تعمل trim() بايتًا بايتًا، والمسافة هي البايتات الثلاثة E3 80 80، وE3 هو أيضًا البايت الأول لكل محرف هيراغانا وكاتاكانا، لذا يخسر الاسم الذي يبدأ بأحدها البايت الأول من ذلك المحرف. استخدم تعبيرًا نمطيًا مع المعدّل u:

<?php
$name = '　さとう 花子　 ';

var_dump(trim($name));   // the full-width spaces stay

// Listing the space as a character breaks さ: the result is not valid UTF-8
var_dump(mb_check_encoding(trim($name, '　'), 'UTF-8'));

function mbTrim(string $s): string
{
    return preg_replace('/\A\s+|\s+\z/u', '', $s);
}

var_dump(mbTrim($name));

يثبّت \A و\z المطابقة عند بداية النص ونهايته. ومع المعدّل u، يطابق \s كل مسافة Unicode: المسافات البيضاء في ASCII، والمسافة كاملة العرض، والمسافة غير القابلة للكسر (U+00A0) التي كثيرًا ما يجلبها النسخ واللصق من صفحات الويب. ودون u، لا يطابق \s إلا مسافات ASCII البيضاء وتبقى المسافة كاملة العرض. تضيف PHP 8.4 الدوال mb_trim() وmb_ltrim() وmb_rtrim() لهذا الغرض؛ وفي PHP 8.3 وما قبلها يكون التعبير النمطي هو الطريق.

تشذيب كل قيمة في مصفوفة

تشذّب array_map('trim', $array) كل قيمة وتحتفظ بالمفاتيح. والحالة النموذجية قائمة مفصولة بفواصل من حقل نصي، مقسّمة بـ explode():

<?php
$tags = explode(',', ' php , mysql,  laravel ,');

$tags = array_map('trim', $tags);
$tags = array_filter($tags, fn($t) => $t !== '');

print_r(array_values($tags));

// An associative array of form fields keeps its keys
$form = ['name' => '  Ada ', 'email' => " ada@example.com\n"];
print_r(array_map('trim', $form));

تشذيب قيمة النموذج قبل التحقق منها

شذّب أولًا، ثم تحقق من النص الفارغ. عندها يُرفض الحقل الذي لا يحتوي إلا مسافات على أنه فارغ. شغّل هذه الكتلة، واكتب اسمًا حوله مسافات في النموذج واضغط Send: يعمل السكربت نفسه مرة أخرى مع امتلاء $_POST.

<?php
$raw = $_POST['name'] ?? '';
$name = trim($raw);
$error = '';

if (($_SERVER['REQUEST_METHOD'] ?? 'GET') === 'POST' && $name === '') {
    $error = 'Please enter your name.';
}
?>
<form method="post">
  <input name="name" value="<?= htmlspecialchars($raw) ?>">
  <button>Send</button>
</form>
<?php if ($error !== ''): ?>
  <p style="color: #c00"><?= $error ?></p>
<?php elseif ($name !== ''): ?>
  <p>Sent "<?= htmlspecialchars($raw) ?>", saved "<?= htmlspecialchars($name) ?>" (<?= strlen($raw) ?> bytes became <?= strlen($name) ?>)</p>
<?php endif; ?>

لا تشذّب كلمات المرور: المسافة في نهاية كلمة المرور جزء منها.