أفضل ممارسات PHP والخطوات التالية

أفضل ممارسات PHP والخطوات التالية

تهانينا على إتمام دورة أساسيات PHP و MySQL! في هذا الدرس الأخير، سنغطي أفضل ممارسات البرمجة ونرشدك في رحلتك لتصبح مطور PHP محترف.

1. تنظيم وهيكلة الكود

الكود المنظم جيدًا أسهل في الصيانة والاختبار والتوسع.

اتبع معايير PSR

توصيات معايير PHP (PSR) توفر معايير برمجة للتوافق المتبادل.

<?php
// PSR-1: معيار البرمجة الأساسي
// - وسوم PHP: استخدم <?php ?> أو <?= ?>، لا تستخدم الوسوم القصيرة أبدًا
// - الترميز: UTF-8 بدون BOM
// - الملفات: إما إعلان رموز أو آثار جانبية، ليس كلاهما

// PSR-12: نمط البرمجة الموسع
namespace App\Controllers;  // إعلان مساحة الاسم

use App\Models\User;       // عبارات use
use App\Services\AuthService;

class UserController         // أسماء الفئات بـ PascalCase
{
    private AuthService $authService;  // الخصائص بـ camelCase

    public function __construct(AuthService $authService)
    {
        $this->authService = $authService;
    }

    public function login(string $username, string $password): bool  // الدوال بـ camelCase
    {
        // مسافة بادئة 4 مسافات (وليس tabs)
        if ($this->authService->validate($username, $password)) {
            return true;
        }

        return false;
    }
}
?>

استخدم أسماء ذات معنى

<?php
// ❌ سيء: أسماء متغيرات غير واضحة
$d = 30;
$u = getU($id);
function proc($x) { /* ... */ }

// ✅ جيد: أسماء وصفية
$daysUntilExpiry = 30;
$user = getUserById($id);
function processPayment($amount) { /* ... */ }

// ✅ جيد: الثوابت بأحرف كبيرة UPPER_CASE
define('MAX_LOGIN_ATTEMPTS', 5);
const DATABASE_HOST = 'localhost';

// ✅ جيد: متغيرات منطقية
$isActive = true;
$hasPermission = false;
$canDelete = checkPermissions($user);
?>

اجعل الدوال صغيرة ومركزة

<?php
// ❌ سيء: الدالة تفعل الكثير
function processUser($data) {
    // التحقق من الصحة
    // الحفظ في قاعدة البيانات
    // إرسال بريد إلكتروني
    // تسجيل النشاط
    // تحديث الذاكرة المؤقتة
    // إرجاع النتيجة
}

// ✅ جيد: مبدأ المسؤولية الواحدة
function validateUserData(array $data): bool {
    return !empty($data['email']) && !empty($data['password']);
}

function saveUser(array $data): int {
    // يحفظ المستخدم في قاعدة البيانات فقط
    $stmt = $pdo->prepare("INSERT INTO users (email, password) VALUES (?, ?)");
    $stmt->execute([$data['email'], $data['password']]);
    return $pdo->lastInsertId();
}

function sendWelcomeEmail(string $email): void {
    // يرسل البريد الإلكتروني فقط
    mail($email, 'مرحبًا!', 'شكرًا لتسجيلك');
}

// تجميعها معًا
function registerUser(array $data): bool {
    if (!validateUserData($data)) {
        return false;
    }

    $userId = saveUser($data);
    sendWelcomeEmail($data['email']);
    logActivity('user_registered', $userId);

    return true;
}
?>

2. أفضل ممارسات معالجة الأخطاء

معالجة الأخطاء الصحيحة تجعل التصحيح أسهل والتطبيقات أكثر قوة.

<?php
// استخدم الاستثناءات لمعالجة الأخطاء
class ValidationException extends Exception {}
class DatabaseException extends Exception {}

function createUser(array $data): User {
    // التحقق من الصحة
    if (empty($data['email'])) {
        throw new ValidationException('البريد الإلكتروني مطلوب');
    }

    // عملية قاعدة البيانات
    try {
        $stmt = $pdo->prepare("INSERT INTO users (email) VALUES (?)");
        $stmt->execute([$data['email']]);
    } catch (PDOException $e) {
        throw new DatabaseException('فشل إنشاء المستخدم: ' . $e->getMessage());
    }

    return new User($pdo->lastInsertId(), $data['email']);
}

// استخدم try-catch في المستويات المناسبة
try {
    $user = createUser($_POST);
    echo "تم إنشاء المستخدم بنجاح";
} catch (ValidationException $e) {
    echo "خطأ في التحقق: " . $e->getMessage();
} catch (DatabaseException $e) {
    error_log($e->getMessage());
    echo "حدث خطأ. يرجى المحاولة مرة أخرى.";
} catch (Exception $e) {
    error_log("خطأ غير متوقع: " . $e->getMessage());
    echo "حدث خطأ غير متوقع.";
}
?>

3. التوثيق والتعليقات

التوثيق الجيد يساعدك ويساعد المطورين الآخرين على فهم الكود.

<?php
/**
 * يحسب السعر الإجمالي بما في ذلك الضريبة
 *
 * @param float $price السعر الأساسي قبل الضريبة
 * @param float $taxRate معدل الضريبة كعدد عشري (مثلاً، 0.15 لـ 15٪)
 * @return float السعر الإجمالي بما في ذلك الضريبة
 * @throws InvalidArgumentException إذا كان السعر أو معدل الضريبة سالبًا
 */
function calculateTotalPrice(float $price, float $taxRate): float {
    if ($price < 0 || $taxRate < 0) {
        throw new InvalidArgumentException('يجب أن يكون السعر ومعدل الضريبة موجبين');
    }

    return $price * (1 + $taxRate);
}

/**
 * فئة نموذج المستخدم
 *
 * يمثل مستخدمًا في النظام بقدرات المصادقة
 */
class User {
    /** @var int معرف المستخدم */
    private int $id;

    /** @var string عنوان البريد الإلكتروني للمستخدم */
    private string $email;

    /** @var array أدوار المستخدم */
    private array $roles;

    // التعليقات الجيدة تشرح لماذا، وليس ماذا
    // ❌ سيء: تعليق واضح
    $total = $price + $tax;  // جمع السعر والضريبة

    // ✅ جيد: يشرح السبب
    // نخزن التجزئة بدلاً من كلمة المرور للأمان
    $passwordHash = password_hash($password, PASSWORD_DEFAULT);

    // ✅ جيد: يشرح المنطق المعقد
    // استخدام عملية bitwise للأداء في الحلقات الضيقة
    // هذا أسرع بـ 10 مرات من modulo لقوى 2
    if (($index & ($size - 1)) === 0) {
        // معالجة كل عنصر Nth
    }
}
?>

4. اختبار الكود

الاختبار يضمن عمل كودك بشكل صحيح ويمنع الانحدارات.

اختبار الوحدة مع PHPUnit

<?php
// تثبيت PHPUnit: composer require --dev phpunit/phpunit

// tests/UserTest.php
use PHPUnit\Framework\TestCase;

class UserTest extends TestCase {
    public function testUserCreation() {
        $user = new User(1, 'test@example.com');

        $this->assertEquals(1, $user->getId());
        $this->assertEquals('test@example.com', $user->getEmail());
    }

    public function testInvalidEmail() {
        $this->expectException(ValidationException::class);

        new User(1, 'invalid-email');
    }

    public function testPasswordHashing() {
        $password = 'secret123';
        $user = new User(1, 'test@example.com');
        $user->setPassword($password);

        // يجب أن تكون كلمة المرور مجزأة
        $this->assertNotEquals($password, $user->getPasswordHash());

        // يجب أن يعمل التحقق
        $this->assertTrue($user->verifyPassword($password));
    }
}

// تشغيل الاختبارات: ./vendor/bin/phpunit tests/
?>

5. أفضل ممارسات الأداء

اكتب كودًا فعالًا يتوسع بشكل جيد.

<?php
// ✅ استخدم العبارات المُعدة مسبقًا (تمنع حقن SQL وتحسن الأداء)
$stmt = $pdo->prepare("SELECT * FROM users WHERE id = ?");
foreach ($ids as $id) {
    $stmt->execute([$id]);
    // معالجة النتيجة
}

// ✅ اجلب الأعمدة المطلوبة فقط
$stmt = $pdo->query("SELECT id, name FROM users");  // جيد
$stmt = $pdo->query("SELECT * FROM users");         // مهدر إذا كنت تحتاج id، name فقط

// ✅ استخدم أوضاع الجلب المناسبة
$users = $stmt->fetchAll(PDO::FETCH_ASSOC);  // يعيد مصفوفة
$user = $stmt->fetchObject(User::class);      // يعيد كائن

// ✅ استخدم الفهرسة للمصفوفات الكبيرة
$userMap = [];
foreach ($users as $user) {
    $userMap[$user['id']] = $user;  // بحث O(1) بدلاً من O(n)
}

// ✅ احفظ العمليات المكلفة في الذاكرة المؤقتة
function getExpensiveData() {
    static $cache = null;

    if ($cache === null) {
        // حساب مكلف
        $cache = performExpensiveOperation();
    }

    return $cache;
}

// ✅ استخدم التخزين المؤقت لكود التشغيل (OPcache)
// تفعيل في php.ini:
// opcache.enable=1
// opcache.memory_consumption=128
// opcache.max_accelerated_files=10000

// ✅ قياس أداء كودك
$start = microtime(true);

// كودك هنا

$duration = microtime(true) - $start;
error_log("استغرقت العملية: " . $duration . " ثانية");
?>

6. التحكم في الإصدارات مع Git

أساسي للتطوير الاحترافي والتعاون.

# تهيئة المستودع
git init
git add .
git commit -m "Initial commit"

# إنشاء ملف .gitignore
vendor/
node_modules/
.env
*.log
.DS_Store

# سير عمل التفريع
git checkout -b feature/user-authentication
# إجراء تغييرات
git add .
git commit -m "إضافة مصادقة المستخدم"
git push origin feature/user-authentication

# الدمج في main
git checkout main
git merge feature/user-authentication
git push origin main

# رسائل commit جيدة
# ❌ سيء
git commit -m "fixed stuff"
git commit -m "changes"

# ✅ جيد
git commit -m "إصلاح خطأ التحقق في نموذج تسجيل المستخدم"
git commit -m "إضافة وظيفة إعادة تعيين كلمة المرور"
git commit -m "إعادة هيكلة اتصال قاعدة البيانات لاستخدام نمط singleton"

7. أطر عمل PHP الحديثة

أطر العمل توفر الهيكل والأمان وتعزيز الإنتاجية.

أطر عمل PHP الشائعة

البدء مع Laravel

# تثبيت Laravel عبر Composer
composer create-project laravel/laravel my-project

# بدء خادم التطوير
cd my-project
php artisan serve

# إنشاء controller
php artisan make:controller UserController

# إنشاء model مع migration
php artisan make:model User -m

# تشغيل migrations
php artisan migrate

# تعريف المسارات (routes/web.php)
Route::get('/users', [UserController::class, 'index']);
Route::post('/users', [UserController::class, 'store']);

# مثال Controller
class UserController extends Controller {
    public function index() {
        $users = User::all();
        return view('users.index', compact('users'));
    }
}

# Eloquent ORM
$users = User::where('active', true)
    ->orderBy('created_at', 'desc')
    ->take(10)
    ->get();

# قوالب Blade (resources/views/users/index.blade.php)
@foreach ($users as $user)
    <div>{{ $user->name }}</div>
@endforeach

8. أدوات وتقنيات أساسية

• Composer: إدارة التبعيات (لقد استخدمت هذا!)
• Docker: الحاويات لبيئات تطوير متسقة
• Xdebug: أداة تصحيح وقياس الأداء
• PHPStan/Psalm: أدوات تحليل ثابت للعثور على الأخطاء
• PHP CS Fixer: تنسيق كود تلقائي
• Postman/Insomnia: أدوات اختبار API

9. خريطة التعلم الخاصة بك

10. بناء محفظتك

مشاريع لإظهار مهاراتك لأصحاب العمل المحتملين:

11. المجتمع والموارد

• PHP.net: التوثيق الرسمي (دائمًا محطتك الأولى)
• Laravel.com: توثيق ودروس إطار العمل
• PHP The Right Way: دليل أفضل الممارسات (phptherightway.com)
• Stack Overflow: أسئلة وأجوبة لمشاكل محددة
• GitHub: اقرأ الكود من المشاريع الشائعة
• Laracasts: دروس فيديو لـ Laravel (وPHP بشكل عام)
• Reddit r/PHP: نقاشات مجتمع PHP

12. نصائح التطوير المهني

13. سوق العمل والمسارات المهنية

كلمات أخيرة

لقد أكملت دورة أساسيات PHP و MySQL وتعلمت:

• صيغة PHP والمتغيرات والدوال وهياكل التحكم
• البرمجة الكائنية مع الفئات والوراثة
• تصميم قاعدة البيانات واستعلامات SQL و PDO للتفاعل مع قاعدة البيانات
• معالجة النماذج ورفع الملفات وإدارة الجلسات
• أفضل ممارسات الأمان لبناء تطبيقات آمنة
• ممارسات وأدوات التطوير الحديثة

شكرًا لك!

شكرًا لك على أخذ هذه الدورة. لديك الآن أساس قوي في PHP و MySQL. الباقي يعود لك - مارس، ابن المشاريع، ولا تتوقف أبدًا عن التعلم. حظًا موفقًا في رحلتك لتصبح مطور PHP محترف!

برمجة سعيدة! 🚀