القفز السريع في تطبيق Symfony الخاص بك: مؤشرات متفرقة و UUIDات عشوائية

في العصر البشري، كانت بسيطة، صغيرة (4 بوصة) ومتعددة بشكل طبيعي. ولكن عندما نذهب نحو أنظمة توزيع، وخدمات ميكروسوفت، وخدمات API المنافسة العالية، بدأت ID الكامل في إظهار أسرارها. فإنه يعرض المعلومات التجارية (يمكنك المنافسة أن تقرأ حجمك) ، فإنه يسهل تدمير البنية التحتية، ويحتاج إلى رحلة طويلة إلى البنية التحتية فقط لمعرفة هوية أي موضوع جديد. id INT AUTO_INCREMENT في حين أن معظم المستثمرين يتوقفون لا تنسى عمق المعمارية التي تقدمها هذه المكونات.في هذه الدليل، سنستعرض تطبيقات متقدمة من في Symfony 7.3 ، تتحرك أكثر من إنتاج الأسس الأساسية لمناقشة تقسيم قاعدة البيانات ، وتصفية مبتكرة و idempotency البيولوجي. “let’s just use UUID v4” symfony/uid التثبيت والمتطلبات نحن نستخدم (بالتأكيد على ميزات 7.x الحديثة) و . Symfony 7.3 Doctrine ORM 3 تأكد من أنك ويعكس التكلفة التالية، ونحن نستخدم بشكل صارم و هي . composer.json symfony/uid Doctrine integration composer require symfony/uid symfony/doctrine-bridge doctrine/orm تحسين أداء قاعدة البيانات: UUID v7 أسوأ خطأ في تطبيقات Symfony الحديثة هو استخدام مثل A . UUID v4 primary key التالي: الانفجار في المؤشر عندما تقوم بإدخال ID عشوائي في مؤشر MySQL / PostgreSQL (B-Tree) ، يجب على قاعدة البيانات الاستمرار في التوازن على الشجرة لإدخال الصفحة الجديدة في "متوسط" من المؤشر. تدمير الإدخالات مع نمو جدول. massive page splitting and fragmentation الحل: UUID v7 UUID v7 (تصنيعًا في RFC 9562 ودعمًا كليًا في Symfony 7.x) يجمع مع البيانات الفورية، وهذا يجعلها إنهم يضغطون في نهاية شجرة B ، مثل عدد صغير من التكلفة الذاتية ، ولكنهم يحافظون على نوعية UUID الوحيدة والموزعة. Unix timestamp (millisecond precision) strictly monotonic تنفيذ لا تعتمد على الدكتوراه سحرية، والتي غالبا ما تكون متوفرة في v4، بدلا من ذلك، بدء ID في المصمم. وهذا يخلق "المعرفة المستمرة" حيث يكون ID متوفرًا قبل التفريغ. @Generatedالقدرة @Generatedالقدرة //src/Entity/Transaction.php namespace App\Entity; use Doctrine\ORM\Mapping as ORM; use Symfony\Component\Uid\Uuid; use Symfony\Component\Uid\UuidV7; #[ORM\Entity] #[ORM\Table(name: 'transactions')] class Transaction { #[ORM\Id] #[ORM\Column(type: 'uuid', unique: true)] private Uuid $id; #[ORM\Column(type: 'string', length: 255)] private string $status; public function __construct(string $status) { // Explicitly generate v7 for time-ordered performance $this->id = new UuidV7(); $this->status = $status; } public function getId(): Uuid { return $this->id; } // ... getters and setters } نوع الدكتورة : يتم تثبيتها تلقائياً، كما هو الحد الأدنى. (القرآن الكريم) أو (فعالية) اعتمادًا على تكوين منصةك.إذا كنت تستخدم نظامًا معيّنًا، فستحكم دائمًا على Doctrine باستخدام 2 إمكانية تخزين الأماكن على ID. ‘uuid’ CHAR(36) BINARY(16) BINARY(16) save 55% التحقق إنشاء نقل: php bin/console make:migration تحقق من SQL، يجب أن ترى العمود المحدد. تحقق من DB؛ يجب أن تكون IDs متزايدة (الشخصيات الأولى سوف تكون متساوية). صفحة عالية الأداء مع ULIDs صفحة الاستخدام و يجب على قاعدة بيانات الحساب أن تبلغ و تفرض الآلاف من الخطوط لتصل إلى صفحة 100. ولكن هذا غالبا ما يتطلب صفحة منفصلة ومحددة (مثل العلامات الزمنية هي خطيرة لأن الأحداث يمكن أن تحدث في نفس النقطة. OFFSET LIMIT Keyset Pagination (Cursor-based) created_at 128 بوصة متوافقة مع التخطيط ULIDs (Universally Unique Lexicographically Sortable Identifier) lexicographically الاستراتيجية وسوف نستخدم a وبما أن ULIDs هي مجلدات قابلة للتعديل، يمكننا أن نقول ببساطة: ULID as the primary key "أرسل لي 10 أشياء حيث ID > [أخير شاهد ULID]". //src/Entity/EventLog.php namespace App\Entity; use Doctrine\ORM\Mapping as ORM; use Symfony\Component\Uid\Ulid; #[ORM\Entity(repositoryClass: \App\Repository\EventLogRepository::class)] class EventLog { #[ORM\Id] #[ORM\Column(type: 'ulid', unique: true)] private Ulid $id; #[ORM\Column(type: 'text')] private string $payload; public function __construct(string $payload) { $this->id = new Ulid(); $this->payload = $payload; } public function getId(): Ulid { return $this->id; } } //src/Repository/EventLogRepository.php namespace App\Repository; use App\Entity\EventLog; use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository; use Doctrine\Persistence\ManagerRegistry; use Symfony\Component\Uid\Ulid; class EventLogRepository extends ServiceEntityRepository { public function __construct(ManagerRegistry $registry) { parent::__construct($registry, EventLog::class); } /** * @return EventLog[] */ public function findAfterCursor(?Ulid $cursor, int $limit = 20): array { $qb = $this->createQueryBuilder('e') ->orderBy('e.id', 'ASC') ->setMaxResults($limit); if ($cursor) { // Efficient index seek $qb->andWhere('e.id > :cursor') ->setParameter('cursor', $cursor->toBinary()); // Note: Depending on your DB type setup, you might pass the object or binary. // The symfony bridge usually handles the object, but explicit binary prevents ambiguity. } return $qb->getQuery()->getResult(); } } هذه الأسئلة تؤثر على مؤشر المفتاح الرئيسي مباشرة. التكلفة بغض النظر عن ما إذا كنت على صفحة 1 أو صفحة 1,000,000. Why this matters? O(1) Idempotence & Deterministic IDs (UUID v5) في أنظمة توزيع (على سبيل المثال، CQRS أو مصدر الأحداث) ، غالباً ما تحصل على نفس الرسالة مرتين (على الأقل مرة واحدة من إرسال). من المفترض أن يقدم A و a (إدخال الشريط) ، فإنه ينتج دائما نفس UUID. UUID v5 Namespace Name السيناريو: استيراد المنتجات من CSV تريد التأكد من أنه إذا قمت بتشغيل كتابة التصدير مرتين، فلن تخلق صفحة متكررة، ولكن تحديث "الهوية" الحالية. //src/Service/ProductIdGenerator.php namespace App\Service; use Symfony\Component\Uid\Uuid; class ProductIdGenerator { // A random UUID v4 constant serving as our private Namespace // Generated once via `php bin/console uuid:generate` private const PRODUCT_NAMESPACE = 'd2e294c8-3829-410e-8baf-7359a58f7051'; public function generateForSku(string $sku): Uuid { // v5 uses SHA-1 hashing to ensure uniqueness based on input return Uuid::v5(Uuid::fromString(self::PRODUCT_NAMESPACE), $sku); } } Usage in a Command: // Inside a command or service $sku = 'WIDGET-ABC-123'; $deterministicId = $this->idGenerator->generateForSku($sku); // $deterministicId will ALWAYS be '...' for SKU 'WIDGET-ABC-123' // You can now safely use: // $em->getReference(Product::class, $deterministicId); URLs Vanity: Shortening UIDs for Humans (تقسيم UID للإنسان) الـمـنـتـدى ( يوتيوب يستخدم Base64/Base58.Symfony Uid لديه دعم داخلية (الطريقة في بيتكوين، لا علامات متباينة مثل 0/O، I/l) و . 123e4567-e89b-12d3-a456–426614174000 Base58 Base32 يمكننا إنشاء يتم تحويل UID إلى Base58 تلقائياً عند إرسال ردود JSON وعودة إلى UUID عند الحصول على طلبات. Symfony Serializer Normalizer // src/Serializer/UuidBase58Normalizer.php namespace App\Serializer; use Symfony\Component\Serializer\Normalizer\DenormalizerInterface; use Symfony\Component\Serializer\Normalizer\NormalizerInterface; use Symfony\Component\Uid\Uuid; use Symfony\Component\DependencyInjection\Attribute\Autowire; class UuidBase58Normalizer implements NormalizerInterface, DenormalizerInterface { public function normalize(mixed $object, ?string $format = null, array $context = []): string|array { /** @var Uuid $object */ return $object->toBase58(); } public function supportsNormalization(mixed $data, ?string $format = null, array $context = []): bool { return $data instanceof Uuid; } public function denormalize(mixed $data, string $type, ?string $format = null, array $context = []): Uuid { // Automatically handle incoming Base58 strings back to UUID objects return Uuid::fromBase58($data); } public function supportsDenormalization(mixed $data, string $type, ?string $format = null, array $context = []): bool { return is_string($data) && is_a($type, Uuid::class, true); } public function getSupportedTypes(?string $format): array { return [ Uuid::class => true, ]; } } The Result: قاعدة بيانات: متجر تحسين 16 بايت binary. رد: {وَالَّذِينَ كَفَرُوا يَتَمَتَّعُونَ وَيَأْكُلُونَ كَمَا تَأْكُلُ الْأَنْعَامُ وَالنَّارُ مَثْوًى لَهُمْ} طلب API: يقوم المستخدم بإرسال BukQLMwS8W5g32, Symfony يتم تحويلها إلى UUID الصحيح لمسألة قاعدة البيانات. مشاهدة فيلم Mocking the Unpredictable اختبار UUID من الصعب جدًا لأن تتغير كل مللي ثانية. Symfony 7 يوفر لتسوية هذا Uuid::v7() MockUuidFactory // tests/Service/TransactionTest.php namespace App\Tests\Service; use PHPUnit\Framework\TestCase; use Symfony\Component\Uid\Factory\MockUuidFactory; use Symfony\Component\Uid\Uuid; use Symfony\Component\Uid\UuidV7; class TransactionTest extends TestCase { public function testItGeneratesPredictableIds(): void { // Define a sequence of IDs the factory should return $expectedId1 = Uuid::fromString('018e69c0-1c00-7c22-b9d6-5c4d00000001'); $expectedId2 = Uuid::fromString('018e69c0-1c00-7c22-b9d6-5c4d00000002'); $factory = new MockUuidFactory([$expectedId1, $expectedId2]); // In your real service, you would inject UuidFactory and use it // $service = new TransactionService($factory); // Simulating usage: $id1 = $factory->create(); $id2 = $factory->create(); $this->assertTrue($id1->equals($expectedId1)); $this->assertTrue($id2->equals($expectedId2)); } } للقيام بهذه العملية في رمز التطبيق الخاص بك ، يجب عليك إزالة إلى خدماتك بدلاً من استخدامها إذا كنت تحتاج إلى اختبار صارم. Symfony\Component\Uid\Factory\UuidFactory new UuidV7() نموذج Benchmark لتثبيت تأثير الأداء vs يجب علينا أن نقيس تأثير "تقسيم الصفحات" في قاعدة البيانات.أمازونات عشوائية تدفع قاعدة البيانات إلى إعادة توازن مؤشر B-Tree باستمرار، في حين أن مؤشرات Monotonic تضاف إلى نهاية. UUID v7 (Monotonic) UUID v4 (Random) This benchmark requires: PhpBench متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح متصفح). مبدئ MySQL/MariaDB المستخدم (محدد في .env الخاص بك). إنشاء هذه الملفات في هذه السيناريوهات تقوم بتشغيل الكناري Symfony للحصول على اتصال البيانات، ويضمن وجود التقويمات ثم قياس سرعة إدخال خام. benchmark/UuidInsertBench.php // benchmark/UuidInsertBench.php namespace App\Benchmark; use App\Kernel; use Doctrine\DBAL\Connection; use PhpBench\Attributes as Bench; use Symfony\Component\Dotenv\Dotenv; use Symfony\Component\Uid\Uuid; use Symfony\Component\Uid\UuidV7; #[Bench\BeforeMethods('setUp')] #[Bench\AfterMethods('tearDown')] class UuidInsertBench { private Connection $connection; private Kernel $kernel; public function setUp(): void { // Bootstrap Symfony to get the DB connection require_once __DIR__ . '/../vendor/autoload.php'; (new Dotenv())->bootEnv(__DIR__ . '/../.env'); $this->kernel = new Kernel($_SERVER['APP_ENV'], (bool) $_SERVER['APP_DEBUG']); $this->kernel->boot(); $this->connection = $this->kernel->getContainer()->get('doctrine.dbal.default_connection'); // distinct tables to isolate index behavior $this->createTable('bench_uuid_v4'); $this->createTable('bench_uuid_v7'); // Seed with initial data to ensure the index has depth // Fragmentation issues only appear when the table isn't empty $this->seedTable('bench_uuid_v4', false); $this->seedTable('bench_uuid_v7', true); } /** * Scenario: Insert into a fragmented index (Random IDs) */ #[Bench\Revs(100)] #[Bench\Iterations(5)] public function benchInsertV4(): void { $uuid = Uuid::v4()->toBinary(); $this->connection->executeStatement( 'INSERT INTO bench_uuid_v4 (id, payload) VALUES (:id, :payload)', ['id' => $uuid, 'payload' => 'benchmark_payload'] ); } /** * Scenario: Insert into a sorted index (Monotonic IDs) */ #[Bench\Revs(100)] #[Bench\Iterations(5)] public function benchInsertV7(): void { $uuid = new UuidV7(); // Explicitly V7 $this->connection->executeStatement( 'INSERT INTO bench_uuid_v7 (id, payload) VALUES (:id, :payload)', ['id' => $uuid->toBinary(), 'payload' => 'benchmark_payload'] ); } private function createTable(string $tableName): void { $sql = connection->executeStatement($sql); // Truncate to ensure clean state per run if needed, // though for this test growing the table is part of the stress test. $this->connection->executeStatement("TRUNCATE TABLE $tableName"); } private function seedTable(string $tableName, bool $isV7): void { // Pre-fill 5,000 rows to create an initial B-Tree structure $sql = "INSERT INTO $tableName (id, payload) VALUES (:id, 'seed_data')"; $stmt = $this->connection->prepare($sql); for ($i = 0; $i toBinary() : Uuid::v4()->toBinary(); $stmt->bindValue('id', $id); $stmt->executeQuery(); } } public function tearDown(): void { $this->connection->executeStatement('DROP TABLE IF EXISTS bench_uuid_v4'); $this->connection->executeStatement('DROP TABLE IF EXISTS bench_uuid_v7'); } } Running the Benchmark: قم بإدخال الخطوة التالية في محفظتك: # Allow 2GB memory for the seeding process if necessary php -d memory_limit=2G vendor/bin/phpbench run benchmark/UuidInsertBench.php --report=default Interpreting Results: من المرجح أن ترى النتائج مماثلة لهذه (المرحلة ستختلف وفقًا للمعدات): +-----------------+-------+---------+----------+----------+---------+ | subject | revs | mem_peak| mode | mean | stdev | +-----------------+-------+---------+----------+----------+---------+ | benchInsertV4 | 100 | 14.20Mb | 850.12μs | 910.45μs | 55.12μs | | benchInsertV7 | 100 | 14.20Mb | 520.40μs | 535.10μs | 12.05μs | +-----------------+-------+---------+----------+----------+---------+ يجب عليك مراقبة هذا لديه فترة أقل من المتوسط وتأخير كبير . Key Takeaway: benchInsertV7 lower standard deviation (stdev) يعني: V7 هو أسرع لأن قاعدة البيانات ببساطة تملأ الصفحة إلى الجانب الأيسر من شجرة B. في بعض الأحيان يضغط على نقطة "المتعة" ، ولكن في كثير من الأحيان يؤدي إلى "تقسيم الصفحة" (العملية الرخيصة لتحرك البيانات)، مما يؤدي إلى ارتفاع في التوقعات. النتيجة لفترة طويلة جداً، كان المتطوعون يتعاملون مع تحديدات قاعدة بيانات البحوث كقطع بسيط من التطبيق - على أساس التحديد. من عادات أو كما رأينا، فإن هذا الخيار له تأثيرات عميقة في النهاية على تمييز التطبيق، والسرعة على صفحة، والواقعية الموزعة. AUTO_INCREMENT UUID v4 مع Symfony 7.3 و المكون Uid ، لا تحتاج إلى التنازل. من جهة أخرى، من جهة أخرى، من جهة أخرى، من جهة أخرى على سبيل المثال (UUID v7) ، يمكن أن يكون بدون إطلاع على أسطوانات الطقس (ULID).نحن قادرون على الاتصال مع منتجنا في المكونات (Base58) مع الحفاظ على تخزيننا بشكل صارم ثنائي. distributed uniqueness insert performance cursor-based pagination human-friendly التبديل إلى هذه المعايير الحديثة هي واحدة من أعلى استردادات الاسترداد التي يمكنك القيام بها على تطوير تطبيقات Symfony. دعونا نتمكن من بناء أنظمة أفضل أنا كتابة بشكل منتظم عن معمارية Symfony عالية الأداء، وتطبيقات الدكتوراه والمشكلات الموزعة. إذا كنت تتعامل مع تحديات متقدمة مماثلة أو لديك أسئلة حول تنفيذ في قوائم التراث الخاص بك: UUID v7 اتصل بنا: https://www.linkedin.com/in/matthew-mochalkin/ بحث: اكتب تعليقًا أدناه مع تجربتك حول تكسير المؤشرات. https://www.linkedin.com/in/matthew-mochalkin/ دعونا نبقى في الاتصال وستواصل الضغط على المعايير.