Filters

✅ أولًا: مقدمة عن التصفية (Filtering) في PHP

📌 PHP توفر مجموعة من الفلترات الجاهزة (Filters) لفحص وتحويل بيانات المستخدم بطريقة آمنة، خاصة عبر:

• $_GET, $_POST, $_REQUEST
• البيانات القادمة من النماذج أو من الـ API

🔹 1. filter_list() – عرض جميع الفلاتر المتوفرة

📘 تُرجع قائمة بكل الفلاتر التي تدعمها PHP:

print_r(filter_list());

🔸 الإخراج:

Array
(
    [0] => int
    [1] => boolean
    [2] => float
    [3] => validate_regexp
    [4] => validate_email
    ...
)

🟢 الفائدة: تعرف أنواع الفلاتر التي تستطيع استخدامها مع filter_var أو filter_input.

🔹 2. filter_id() – جلب رقم الفلتر من اسمه

📘 بعض الدوال تطلب رقم الفلتر (ID) بدل اسمه، استخدم هذه الدالة للحصول عليه:

echo filter_id("validate_email"); // مثلاً تُخرج 274

🟢 الفائدة: تستخدمها عندما تحتاج تمرير الـ ID بشكل ديناميكي بدل كتابة اسم الفلتر مباشرة.

🔹 3. filter_var() – تصفية أو التحقق من قيمة

📘 أهم دالة، تُستخدم للتحقق أو تصفية قيمة واحدة مثل بريد إلكتروني، رقم، عنوان URL…

🧪 مثال 1: التحقق من بريد إلكتروني

$email = "[email protected]";

if (filter_var($email, FILTER_VALIDATE_EMAIL)) {
    echo "بريد صحيح ✅";
} else {
    echo "بريد خاطئ ❌";
}

🧪 مثال 2: التحقق من عدد صحيح

$num = "123";

if (filter_var($num, FILTER_VALIDATE_INT)) {
    echo "عدد صحيح";
}

🧪 مثال 3: تصفية رقم (إزالة الحروف)

$value = "100abc";

$clean = filter_var($value, FILTER_SANITIZE_NUMBER_INT);
echo $clean;  // 100

🧪 مثال 4: تصفية URL

$url = "https://google.com";

if (filter_var($url, FILTER_VALIDATE_URL)) {
    echo "رابط صحيح";
}

💡 فلترة vs تحقق

📋 أهم الفلاتر المستخدمة:

⚠️ محاذير ونصائح:

• ✅ استخدم الفلاتر دومًا مع مدخلات المستخدم.
• ❌ لا تعتمد فقط على JavaScript في التحقق (التحقق يجب أن يكون من السيرفر أيضًا).
• ⚠️ FILTER_SANITIZE_STRING تم إزالته من PHP 8.1، فانتبه عند التحديث.
• 🔐 الفلاتر لا تغني عن التحقق الأمني العميق (مثل Prepared Statements لقاعدة البيانات).

🧠 مثال تطبيقي واقعي:

$username = $_GET["user"];

if (filter_var($username, FILTER_SANITIZE_STRING)) {
    echo "مرحبًا، " . $username;
} else {
    echo "اسم غير صالح!";
}

🔴 ⚠️ لكن كما ذكرنا أعلاه، FILTER_SANITIZE_STRING تم إزالته في PHP 8.1، لذلك الأفضل استخدام:

$username = htmlspecialchars($_GET["user"]);

🔹 أولًا: أنواع الفلاتر (Filters) في PHP

تنقسم الفلاتر إلى نوعين:

✅ 1. Validation Filters (فلاتر التحقق)

تُستخدم لفحص ما إذا كانت القيمة صالحة (مناسبة لنوع معين).

🧪 مثال: FILTER_VALIDATE_INT

$age = "25";
if (filter_var($age, FILTER_VALIDATE_INT)) {
    echo "عمر صالح";
}

✅ 2. Sanitizing Filters (فلاتر التنقية)

تقوم بإزالة أو تعديل القيم غير الصالحة لتصبح آمنة.

🧪 مثال: FILTER_SANITIZE_EMAIL

$email = "bad_email@@@example.com";
$clean = filter_var($email, FILTER_SANITIZE_EMAIL);
echo $clean; // "[email protected]"

🔧 خيارات إضافية (Flags) يمكن استخدامها مع الفلاتر

مثلًا في FILTER_VALIDATE_INT يمكن إضافة خيارات:

$age = "20";

$options = [
    "options" => [
        "min_range" => 18,
        "max_range" => 40
    ]
];

if (filter_var($age, FILTER_VALIDATE_INT, $options)) {
    echo "مقبول بالعمر";
}

✳️ filter_input() – تصفية مباشرة من مدخلات المستخدم

$email = filter_input(INPUT_GET, "email", FILTER_VALIDATE_EMAIL);

🔸 تقرأ مباشرة من $_GET أو $_POST وتُطبق الفلتر.

🧠 ملخص لأهم الفلاتر العملية:

⚠️ نصائح ومحاذير:

• ⚠️ لا تستخدم FILTER_SANITIZE_STRING في PHP 8.1 وما بعدها لأنه تم حذفه.
• ✅ استخدم htmlspecialchars() عند إخراج البيانات في HTML لحماية XSS.
• ✅ فلاتر PHP مفيدة لكنها لا تغني عن التحقق الكامل عند التعامل مع قاعدة بيانات (استخدم دائمًا Prepared Statements).

✅ فلاتر التحقق (Validation Filters) الإضافية

✅ فلاتر التنقية (Sanitization Filters) الإضافية

⚠️ FILTER_SANITIZE_STRING تم حذفه من PHP 8.1، ولا يُنصح باستخدامه.

🔧 الأعلام (Flags) المساعدة للفلاتر

تستخدم لتعديل سلوك الفلاتر:

مع FILTER_VALIDATE_INT أو FLOAT:

مع FILTER_VALIDATE_EMAIL و URL:

مع FILTER_VALIDATE_IP:

💡 دوال مهمة مرتبطة بالفلاتر

🧪 مثال عملي متقدم:

$data = [
    'email' => '[email protected]',
    'age'   => '25',
    'url'   => 'https://example.com?ref=1'
];

$filters = [
    'email' => FILTER_VALIDATE_EMAIL,
    'age'   => ['filter' => FILTER_VALIDATE_INT, 'options' => ['min_range' => 18]],
    'url'   => ['filter' => FILTER_VALIDATE_URL, 'flags' => FILTER_FLAG_PATH_REQUIRED]
];

$result = filter_var_array($data, $filters);

print_r($result);