Release v0.7.0

CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+# Release Notes for 0.7.x
+
+## [v0.7.0 (2025-09-26)](https://github.com/phenixphp/framework/compare/0.6.0...0.7.0)
+
+### Added
+
+- Event system. ([#67](https://github.com/phenixphp/framework/pull/67))
+
 # Release Notes for 0.6.x
 
 ## [v0.6.0 (2025-08-22)](https://github.com/phenixphp/framework/compare/0.5.2...0.6.0)

src/App.php

@@ -12,6 +12,8 @@
 use Amp\Socket;
 use League\Container\Container;
 use League\Uri\Uri;
+use Mockery\LegacyMockInterface;
+use Mockery\MockInterface;
 use Monolog\Logger;
 use Phenix\Console\Phenix;
 use Phenix\Contracts\App as AppContract;
@@ -105,6 +107,11 @@ public static function make(string $key): object
         return self::$container->get($key);
     }
 
+    public static function fake(string $key, LegacyMockInterface|MockInterface $concrete): void
+    {
+        self::$container->extend($key)->setConcrete($concrete);
+    }
+
     public static function path(): string
     {
         return self::$path;

src/Console/Commands/MakeModel.php

@@ -102,7 +102,9 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
         File::put($filePath, $stub);
 
-        $output->writeln(["<info>{$this->commonName()} successfully generated!</info>", self::EMPTY_LINE]);
+        $outputPath = str_replace(base_path(), '', $filePath);
+
+        $output->writeln(["<info>{$this->commonName()} [{$outputPath}] successfully generated!</info>", self::EMPTY_LINE]);
 
         return parent::SUCCESS;
     }

src/Console/Maker.php

@@ -48,7 +48,9 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
         File::put($filePath, $stub);
 
-        $output->writeln(["<info>{$this->commonName()} successfully generated!</info>", self::EMPTY_LINE]);
+        $outputPath = str_replace(base_path(), '', $filePath);
+
+        $output->writeln(["<info>{$this->commonName()} [{$outputPath}] successfully generated!</info>", self::EMPTY_LINE]);
 
         return Command::SUCCESS;
     }

src/Database/Console/MakeSeeder.php

@@ -36,7 +36,7 @@ protected function configure(): void
 
     protected function outputDirectory(): string
     {
-        return 'database' . DIRECTORY_SEPARATOR . 'seeds';
+        return 'database' . DIRECTORY_SEPARATOR . 'seeders';
     }
 
     protected function stub(): string

src/Events/AbstractEvent.php

@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Phenix\Events;
+
+use Phenix\Events\Contracts\Event as EventContract;
+
+abstract class AbstractEvent implements EventContract
+{
+    protected mixed $payload = null;
+
+    protected bool $propagationStopped = false;
+
+    public function getName(): string
+    {
+        return static::class;
+    }
+
+    public function getPayload(): mixed
+    {
+        return $this->payload;
+    }
+
+    public function isPropagationStopped(): bool
+    {
+        return $this->propagationStopped;
+    }
+
+    public function stopPropagation(): void
+    {
+        $this->propagationStopped = true;
+    }
+}

src/Events/AbstractListener.php

@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Phenix\Events;
+
+use Closure;
+use Phenix\Events\Contracts\Event;
+use Phenix\Events\Contracts\EventListener as EventListenerContract;
+
+abstract class AbstractListener implements EventListenerContract
+{
+    protected int $priority = 0;
+
+    protected bool $once = false;
+
+    abstract public function handle(Event $event): mixed;
+
+    public function setPriority(int $priority): self
+    {
+        $this->priority = $this->normalizePriority($priority);
+
+        return $this;
+    }
+
+    public function getPriority(): int
+    {
+        return $this->priority;
+    }
+
+    public function shouldHandle(Event $event): bool
+    {
+        return true;
+    }
+
+    public function isOnce(): bool
+    {
+        return $this->once;
+    }
+
+    public function setOnce(bool $once = true): self
+    {
+        $this->once = $once;
+
+        return $this;
+    }
+
+    public function getHandler(): Closure|static|string
+    {
+        return $this;
+    }
+
+    protected function normalizePriority(int $priority): int
+    {
+        return max(0, min($priority, 100));
+    }
+}

src/Events/Console/MakeEvent.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Phenix\Events\Console;
+
+use Phenix\Console\Maker;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputOption;
+
+#[AsCommand(
+    name: 'make:event',
+    description: 'Create a new event class'
+)]
+class MakeEvent extends Maker
+{
+    protected function configure(): void
+    {
+        $this->addArgument('name', InputArgument::REQUIRED, 'The name of the event');
+
+        $this->addOption('force', 'f', InputOption::VALUE_NONE, 'Force to create event');
+    }
+
+    protected function outputDirectory(): string
+    {
+        return 'app' . DIRECTORY_SEPARATOR . 'Events';
+    }
+
+    protected function commonName(): string
+    {
+        return 'Event';
+    }
+
+    protected function stub(): string
+    {
+        return 'event.stub';
+    }
+}

src/Events/Console/MakeListener.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Phenix\Events\Console;
+
+use Phenix\Console\Maker;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputOption;
+
+#[AsCommand(
+    name: 'make:listener',
+    description: 'Create a new event listener class'
+)]
+class MakeListener extends Maker
+{
+    protected function configure(): void
+    {
+        $this->addArgument('name', InputArgument::REQUIRED, 'The name of the listener');
+
+        $this->addOption('force', 'f', InputOption::VALUE_NONE, 'Force to create listener');
+    }
+
+    protected function outputDirectory(): string
+    {
+        return 'app' . DIRECTORY_SEPARATOR . 'Listeners';
+    }
+
+    protected function commonName(): string
+    {
+        return 'Event Listener';
+    }
+
+    protected function stub(): string
+    {
+        return 'listener.stub';
+    }
+}

src/Events/Contracts/Event.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Phenix\Events\Contracts;
+
+interface Event
+{
+    public function getName(): string;
+
+    public function getPayload(): mixed;
+
+    public function isPropagationStopped(): bool;
+
+    public function stopPropagation(): void;
+}

src/Events/Contracts/EventEmitter.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Phenix\Events\Contracts;
+
+use Amp\Future;
+use Closure;
+
+interface EventEmitter
+{
+    public function on(string $event, Closure|EventListener|string $listener, int $priority = 0): void;
+
+    public function once(string $event, Closure|EventListener|string $listener, int $priority = 0): void;
+
+    public function off(string $event, Closure|EventListener|string|null $listener = null): void;
+
+    public function emit(string|Event $event, mixed $payload = null): array;
+
+    public function emitAsync(string|Event $event, mixed $payload = null): Future;
+
+    public function getListeners(string $event): array;
+
+    public function hasListeners(string $event): bool;
+
+    public function removeAllListeners(): void;
+}

src/Events/Contracts/EventListener.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Phenix\Events\Contracts;
+
+use Closure;
+
+interface EventListener
+{
+    public function handle(Event $event): mixed;
+
+    public function getPriority(): int;
+
+    public function setPriority(int $priority): self;
+
+    public function shouldHandle(Event $event): bool;
+
+    public function isOnce(): bool;
+
+    public function setOnce(bool $once = true): self;
+
+    public function getHandler(): Closure|static|string;
+}

src/Events/Event.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Phenix\Events;
+
+class Event extends AbstractEvent
+{
+    protected float $timestamp;
+
+    public function __construct(
+        protected string $name,
+        mixed $payload = null
+    ) {
+        $this->payload = $payload;
+        $this->timestamp = microtime(true);
+    }
+
+    public function getTimestamp(): float
+    {
+        return $this->timestamp;
+    }
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+}