yang Komponen telah lama menjadi salah satu permata yang paling berkuasa, tetapi kurang digunakan, kerangka kerja.Ia membolehkan pemaju untuk memisahkan logik proses perniagaan daripada keadaan entiti, menukar pemeriksaan status "kode spaghetti" yang kompleks kepada grafik terarah yang bersih dan boleh dilihat. symfony/workflow Selama bertahun-tahun, bagaimanapun, komponen ini mempunyai batasan yang ketat yang berakar dalam pelaksanaan rangkaian Petri: Walaupun anda boleh berada di beberapa tempat pada masa yang sama (proses paralel), anda tidak boleh berada di tempat yang sama beberapa kali. Tokens were boolean Symfony 7.4 changes the game with Weighted Transitions. Ciri-ciri baru ini memperkenalkan Anda kini boleh memodelkan senario di mana kuantiti penting: "mempunyai 4 tanda tangan," "proses 5 item batch," atau "tunggu 3 subsistem untuk dimulakan." multiplicity Dalam artikel ini, kami akan membina sebuah Kami akan meneroka bagaimana untuk mengkonfigurasi transisi berimbang, melaksanakan logik entiti, dan mengesahkan aliran dengan ujian yang ketat - semua menggunakan Symfony 7.4 dan PHP 8.3. Multi-Signature Approval System Konsep (Petri Nets vs. Mesin Negara) Sebelum menulis kod, ia adalah penting untuk memahami mengapa ciri ini wujud. Pembatasan Mesin Negara Mesin negara adalah linear. lif juga daripada atau Ia tidak boleh menjadi ini sempurna untuk status yang lebih mudah (contohnya, ) daripada STOPPED MOVING_UP MOVING_DOWN MOVING_UP Order::STATUS_PAID Rangkaian Kerja (Petri Net) A ialah membolehkan objek untuk duduk di beberapa tempat pada masa yang sama. Dalam proses "Pekerja Baru Onboarding", seorang pekerja boleh bersamaan berada dalam: Workflow 
 
 
 Perkhidmatan_Laptop Mencipta Akaun E-mel Kedua-duanya mesti diselesaikan sebelum mereka berpindah ke . onboarded Bahagian yang hilang: Multiplikasi Sebelum Symfony 7.4, jika anda memerlukan "3 Pengurus untuk mengesahkan perbelanjaan," anda tidak boleh memodelkan ini semata-mata dalam aliran kerja. 
 
 
 
 Mencipta waiting_for_approval tempat. Tambah medan counter kepada entiti anda ($approvalCount). Gunakan pendengar Event Guard untuk memeriksa jika ($subject->getApprovalCount() >= 3) sebelum membenarkan transisi. dengan yang » ” kini sebahagian daripada keadaan aliran kerja itu sendiri. Enjin aliran kerja secara semula jadi memahami bahawa subjek berada dalam Terdapat 3 kali. Weighted Transitions counter approved Projek Setup Mari kita mencipta projek Symfony baru dan memasang komponen yang diperlukan. composer create-project symfony/skeleton:"7.4.*" fintech-approval
cd fintech-approval
composer require symfony/workflow symfony/framework-bundle symfony/orm-pack symfony/maker-bundle
 Untuk contoh ini, kami akan menggunakan SQLite untuk kesederhanaan, tetapi logik berlaku untuk MySQL / PostgreSQL persis sama. # .env
DATABASE_URL="sqlite:///%kernel.project_dir%/var/data.db"
 Konfigurasi (The Core Logic) Ini ialah di mana sihir berlaku. kita akan menentukan aliran kerja yang dipanggil expense_approval. The Scenario: 
 
 
 
 
 
 Laporan perbelanjaan telah diwujudkan (Rencana). Ia telah dihantar (review_required) Langkah Dipertimbangkan: Sistem membahagikan permintaan kepada 3 penerima yang diperlukan. Setiap penerima memberi kelulusan secara individu. Sebaik sahaja 3 kelulusan dikumpul, kos bergerak ke ready_for_payment. Mencipta atau mengemas kini : config/packages/workflow.yaml # config/packages/workflow.yaml
framework:
    workflows:
        expense_approval:
            type: workflow # MUST be 'workflow', not 'state_machine'
            audit_trail:
                enabled: true
            marking_store:
                type: method
                property: currentState # This must hold an array
            
            supports:
                - App\Entity\ExpenseReport

            initial_marking: draft

            places:
                - draft
                - review_pool
                - approved_pool
                - ready_for_payment
                - rejected

            transitions:
                submit:
                    from: draft
                    to:
                        - place: review_pool
                          weight: 3 # <--- OUTPUT WEIGHT
                          
                approve:
                    from: review_pool
                    to: approved_pool
                    # Default weight is 1. One 'review_pool' token becomes one 'approved_pool' token.

                reject:
                    from: review_pool
                    to: rejected
                    # If rejected, we might want to clear all tokens, 
                    # but for simplicity, one rejection moves to rejected.

                finalize:
                    from:
                        - place: approved_pool
                          weight: 3 # <--- INPUT WEIGHT
                    to: ready_for_payment
 Menyelesaikan Konfigurasi 
 
 
 
 
 Jenis: aliran kerja: Peralihan yang dipertaruhkan bergantung kepada bucket token. Ini tidak mungkin dalam mesin negara. submitTransition:- kepada: { tempat: review_pool, berat: 3 } - Apabila ini terbakar, thereview_poolplace menerima 3 token.- Pikirkan ini sebagai mewujudkan3 “ticket” yang perlu dipukul. menyetujuiTransition:-dari: review_pool, kepada: disetujui_pool.- Standard 1-to-1 berat.- Kerana kita mempunyai 3 token inreview_pool, kita boleh menembak transisi ini 3 kali. finalizeTransition:- dari: { tempat: disetujui_pool, berat: 3 }- Transisi ini dihalang sehingga disetujui_pool mengandungi tepat (atau sekurang-kurangnya) 3 token.- Sebaik sahaja disetujui ke-3 datang, laluan ini dibuka. entiti yang Kami memerlukan entiti yang menyokong kedai penanda "Multi-State". properti mesti merupakan array untuk mengekalkan bilangan token (contohnya, ) daripada currentState [‘review_pool’ => 2, ‘approved_pool’ => 1] 
namespace App\Entity;

use App\Repository\ExpenseReportRepository;
use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity(repositoryClass: ExpenseReportRepository::class)]
class ExpenseReport
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column]
    private ?int $id = null;

    #[ORM\Column(length: 255)]
    private string $description;

    #[ORM\Column]
    private float $amount;

    /**
     * Stores the workflow state.
     * For Weighted Workflows, this stores the places and their quantities.
     * Example DB content: {"review_pool": 2, "approved_pool": 1}
     */
    #[ORM\Column(type: 'json')]
    private array $currentState = [];

    public function __construct(string $description, float $amount)
    {
        $this->description = $description;
        $this->amount = $amount;
        // Initial marking is handled by the workflow component, 
        // but initializing to empty array is good practice.
    }

    public function getId(): ?int
    {
        return $this->id;
    }

    public function getDescription(): string
    {
        return $this->description;
    }

    public function getAmount(): float
    {
        return $this->amount;
    }

    public function getCurrentState(): array
    {
        return $this->currentState;
    }

    public function setCurrentState(array $currentState): self
    {
        $this->currentState = $currentState;
        return $this;
    }
}
 Menjalankan migrasi : php bin/console make:migration
php bin/console doctrine:migrations:migrate
 Layer Perkhidmatan Untuk berinteraksi dengan aliran kerja ini dengan bersih, kita perlu mencipta perkhidmatan. perkhidmatan ini akan menangani logik "siapa" yang menyetujui, walaupun untuk tutorial ini, kita akan memberi tumpuan kepada mekanik aliran kerja. 
namespace App\Service;

use App\Entity\ExpenseReport;
use Symfony\Component\Workflow\WorkflowInterface;
use Symfony\Component\Workflow\Registry;

readonly class ExpenseManager
{
    public function __construct(
        private Registry $workflowRegistry,
    ) {}

    public function submit(ExpenseReport $expense): void
    {
        $workflow = $this->getWorkflow($expense);
        
        if ($workflow->can($expense, 'submit')) {
            $workflow->apply($expense, 'submit');
        } else {
            throw new \LogicException('Cannot submit this expense report.');
        }
    }

    public function approve(ExpenseReport $expense): void
    {
        $workflow = $this->getWorkflow($expense);

        // In a real app, you would check "Is the current user one of the allowed approvers?" here.
        
        if ($workflow->can($expense, 'approve')) {
            $workflow->apply($expense, 'approve');
            
            // Check if we can auto-finalize (if 3 approvals are met)
            if ($workflow->can($expense, 'finalize')) {
                $workflow->apply($expense, 'finalize');
            }
        } else {
            throw new \LogicException('Approval not needed or not allowed.');
        }
    }
    
    public function getStatus(ExpenseReport $expense): array
    {
        // returns something like ['review_pool' => 2, 'approved_pool' => 1]
        return $expense->getCurrentState();
    }

    private function getWorkflow(ExpenseReport $expense): WorkflowInterface
    {
        return $this->workflowRegistry->get($expense, 'expense_approval');
    }
}
 Logik “Auto-Finalize” Nota kaedah persetujuan.Selepas mengaplikasikan persetujuan, kami segera memeriksa boleh ($cost, ‘finalize’). 
 
 
 
 FirstApproval:-review_pool: 2-approved_pool: 1-finalize perlu 3 approved_pool. boleh(‘finalize’) mengembalikan palsu. SecondApproval:-review_pool: 1-approved_pool: 2-can(‘finalize’) mengembalikan palsu. ThirdApproval:review_pool: 0approved_pool: 3finalize needs 3. can(‘finalize’) mengembalikan true.We applyfinalize.New State:ready_for_payment: 1. Visualisasi aliran kerja Sebelum menguji, ia sangat membantu untuk memvisualisasikan grafik, terutamanya dengan berat yang terlibat. php bin/console workflow:dump expense_approval | dot -Tpng -o workflow.png
 Anda memerlukan graphviz dipasang pada mesin anda untuk menggunakan dot. Jika anda tidak mempunyai ia, anda boleh melampirkan output teks ke dalam penonton Graphviz dalam talian. Hasilnya akan secara visual mewakili anak panah dengan label seperti berat: 3, membuatnya jelas bahawa transisi mengemukakan melahirkan beberapa token. Pengesahan Unit (Unit Testing) Kami tidak hanya berharap ia berfungsi; kami membuktikannya. untuk memuatkan konfigurasi aliran kerja sebenar dan menguji transisi. KernelTestCase //tests/Workflow/ExpenseApprovalWorkflowTest.php
namespace App\Tests\Workflow;

use App\Entity\ExpenseReport;
use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
use Symfony\Component\Workflow\WorkflowInterface;

class ExpenseApprovalWorkflowTest extends KernelTestCase
{
    private WorkflowInterface $workflow;

    protected function setUp(): void
    {
        self::bootKernel();
        $container = static::getContainer();
        $registry = $container->get('workflow.registry');
        
        // We create a dummy subject to get the workflow
        // In a real app, passing the class name to the registry is preferred if supported,
        // or fetching by name directly if you have a custom service alias.
        $subject = new ExpenseReport('Test', 100.0);
        $this->workflow = $registry->get($subject, 'expense_approval');
    }

    public function testWeightedApprovalFlow(): void
    {
        $expense = new ExpenseReport('MacBook Pro', 3000.00);

        // 1. Initial State
        $this->assertTrue($this->workflow->can($expense, 'submit'));
        $this->workflow->apply($expense, 'submit');

        // Verify tokens: Should be in review_pool 3 times
        $marking = $expense->getCurrentState();
        $this->assertArrayHasKey('review_pool', $marking);
        $this->assertEquals(3, $marking['review_pool'], 'Should have 3 pending reviews');

        // 2. First Approval
        $this->assertTrue($this->workflow->can($expense, 'approve'));
        $this->workflow->apply($expense, 'approve');
        
        $marking = $expense->getCurrentState();
        $this->assertEquals(2, $marking['review_pool']);
        $this->assertEquals(1, $marking['approved_pool']);

        // Check that we CANNOT finalize yet (need 3 approvals)
        $this->assertFalse($this->workflow->can($expense, 'finalize'), 'Should not finalize with only 1 approval');

        // 3. Second Approval
        $this->workflow->apply($expense, 'approve');
        $marking = $expense->getCurrentState();
        $this->assertEquals(1, $marking['review_pool']);
        $this->assertEquals(2, $marking['approved_pool']);

        // 4. Third Approval
        $this->workflow->apply($expense, 'approve');
        $marking = $expense->getCurrentState();
        
        // At this specific moment, review_pool is 0, approved_pool is 3
        $this->assertEquals(0, $marking['review_pool'] ?? 0);
        $this->assertEquals(3, $marking['approved_pool']);

        // 5. Finalize
        $this->assertTrue($this->workflow->can($expense, 'finalize'), 'Should be able to finalize now');
        $this->workflow->apply($expense, 'finalize');

        // 6. Verify End State
        $marking = $expense->getCurrentState();
        $this->assertArrayHasKey('ready_for_payment', $marking);
        $this->assertEquals(1, $marking['ready_for_payment']);
        // Previous tokens should be consumed
        $this->assertArrayNotHasKey('approved_pool', $marking);
    }
}
 Lakukan ujian ini: php bin/phpunit tests/Workflow/ExpenseApprovalWorkflowTest.php
 Penggunaan lanjutan & amalan terbaik Menggunakan Enums untuk Tempat (baharu dalam 7.4) Symfony 7.4 juga menambah sokongan untuk Backed Enums dalam aliran kerja. “Anda perlu mendefinisikan Enum. review_pool namespace App\Enum;

enum ExpenseState: string
{
    case DRAFT = 'draft';
    case REVIEW_POOL = 'review_pool';
    case APPROVED_POOL = 'approved_pool';
    case READY = 'ready_for_payment';
    case REJECTED = 'rejected';
}
 Anda kemudian boleh mengemas kini workflow.yaml anda (walaupun YAML masih menggunakan string, kod PHP anda boleh menggunakan ) daripada ExpenseState::REVIEW_POOL->value Peristiwa-peristiwa dengan berat Anda mungkin mahu mengelakkan perkara yang sama daripada mengesahkan 3 kali. transisi yang dipertaruhkan membolehkan transisi untuk dipanggil 3 kali, tetapi enjin aliran kerja tidak tahu siapa yang memanggilnya. person approve Untuk menyelesaikan masalah ini, gunakan penjaga pendengaran. #[AsEventListener('workflow.expense_approval.guard.approve')]
public function preventDoubleApproval(GuardEvent $event): void
{
    /** @var ExpenseReport $expense */
    $expense = $event->getSubject();
    $user = $this->security->getUser();

    // Imagine the entity has a list of who already approved
    if ($expense->hasApproved($user)) {
        $event->setBlocked(true, 'You have already approved this expense.');
    }
}
 Pembersihan Token (Token Cleanup) Satu cabaran dengan token berimbang ialah membersihkan.Jika kita mempunyai 2 kelulusan dan orang ketiga memanggil apa yang berlaku kepada 2 token yang duduk di ? reject approved_pool Dalam aliran kerja biasa, bergerak ke boleh tinggalkan mereka Token menjejaskan (menciptakan keadaan zombie di mana laporan kedua-dua ditolak dan sebahagian disetujui). rejected approved_pool yang transisi hendaklah ideal untuk mengkonsumsi Walau bagaimanapun, penggunaan dinamik tidak disokong semata-mata dalam YAML (Anda tidak boleh mengatakan "konsumsi SEMUA"). reject all Menggunakan Event Subscriber pada , anda boleh mengeset semula kedai penanda secara manual. workflow.entered.rejected public function onRejected(Event $event): void
{
    $expense = $event->getSubject();
    // Force reset state to ONLY rejected
    $expense->setCurrentState(['rejected' => 1]);
}
 Kesimpulan Kumpulan Simfoni 7.4 Dengan membenarkan beberapa contoh keadaan (token) untuk wujud secara bersamaan, kita kini boleh memodelkan sistem voting, pengeluaran barisan perhimpunan, dan logik pemprosesan batch secara langsung dalam konfigurasi, secara drastik mengurangkan jumlah boilerplate PHP tersuai yang diperlukan. Weighted Workflow Transitions Key Takeaways: 
 
 
 
 
 Multiplicity: Lokasi boleh memegang banyak token, membolehkan pengumpulan keadaan secara paralel. Konfigurasi: Gunakan berat dalam definisi anda untuk (output) dan daripada (input) untuk mengawal aliran token. Penyimpanan: Pastikan properti Marking Store anda adalah array (contohnya, lajur JSON) untuk menjejaki bilangan token per lokasi. Verifikasi: Selalu gunakan perintah aliran kerja:dump dan tulis ujian KernelTestCase untuk membuktikan logik grafik anda sebelum penyebaran. Ciri ini mengukuhkan komponen Workflow Symfony sebagai penyelesaian PHP terkemuka untuk pengurusan keadaan, membolehkan anda memadamkan sifat-sifat yang rapuh dan bergantung kepada seni bina yang sihat secara matematik. Mari kita bersentuhan Mengadopsi corak lanjutan ini boleh menyederhanakan logik domain anda secara signifikan, tetapi peralihan itu tidak selalu jelas.Jika anda sedang mencari untuk memodernisasi tumpukan Symfony anda, perlukan mata kedua pada seni bina anda, atau hanya mahu terkejut dengan pelaksanaan Petri net terbaru, saya ingin mendengar daripada anda. Hubungi saya di Linkedin ( ) untuk meneruskan perbualan mengenai seni bina PHP moden. https://www.linkedin.com/in/matthew-mochalkin/ https://www.linkedin.com/in/matthew-mochalkin/

Read My Stories

Audio ini dihasilkan dalam bahasa asal cerita!

Berikut ialah cara anda boleh membina sistem kelulusan FinTech dengan Symfony 7.4

About Author

KOMEN

GANTUNG TANDA

ARTIKEL INI DIBENTANGKAN DALAM

Related Stories

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps