Merged to master

.github/FUNDING.yml

@@ -1,5 +1,5 @@
 # These are supported funding model platforms
 
-github: [papac]
+github: [ papac ]
 open_collective: bowphp
-custom: ["https://www.buymeacoffee.com/iOLqZ3h"]
+custom: [ "https://www.buymeacoffee.com/iOLqZ3h" ]

.github/ISSUE_TEMPLATE.md

@@ -5,7 +5,7 @@ If you would like to propose new Bow features, please make a pull request, or op
 - Version: #.#.#
 - Tintin Version: #.#.#
 - PHP Version: #.#.#
-- Database Driver & Version: Mysql|Sqlite
+- Database Adapters & Version: Mysql|Sqlite
 
 ### Description
 

.github/workflows/coding-standards.yml

@@ -19,7 +19,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Setup PHP
         uses: shivammathur/setup-php@v2

.github/workflows/tests.yml

@@ -3,54 +3,65 @@ name: bowphp
 on: [ push, pull_request ]
 
 env:
-  FTP_HOST: localhost
-  FTP_USER: username
-  FTP_PASSWORD: password
-  FTP_PORT: 21
-  FTP_ROOT: /tmp
+  AWS_KEY: ${{ secrets.AWS_KEY }}
+  AWS_SECRET: ${{ secrets.AWS_SECRET }}
+  AWS_ENDPOINT: ${{ secrets.AWS_ENDPOINT }}
+  SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}
+  AWS_REGION: ${{ secrets.AWS_REGION }}
+  AWS_S3_BUCKET: ${{ secrets.AWS_S3_BUCKET }}
 
 jobs:
   lunix-tests:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        php: [8.1, 8.2, 8.3]
+        php: [8.1, 8.2, 8.3, 8.4]
         os: [ubuntu-latest]
         stability: [prefer-lowest, prefer-stable]
 
     name: PHP ${{ matrix.php }} - ${{ matrix.stability }} - ${{ matrix.os }}
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v2
-
-      - name: Setup MySQL
-        uses: mirromutth/mysql-action@v1.1
-        with:
-          host port: 3306
-          container port: 3306
-          character set server: 'utf8mb4'
-          collation server: 'utf8mb4_general_ci'
-          mysql version: '5.7'
-          mysql database: 'test_db'
-          mysql root password: 'password'
+        uses: actions/checkout@v4
 
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php }}
-          extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, mysql, sqlite, pdo_sqlite, bcmath, soap, intl, gd, exif, iconv, imagick, redis
+          extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, mysql, sqlite, pgsql, pdo_mysql, pdo_pgsql, pdo_sqlite, bcmath, soap, intl, gd, exif, iconv, imagick, redis
           coverage: none
 
-      - run: docker run -p 21:21 -p 20:20 -p 12020:12020 -p 12021:12021 -p 12022:12022 -p 12023:12023 -p 12024:12024 -p 12025:12025 -e USER=$FTP_USER -e PASS=$FTP_PASSWORD -d --name ftp papacdev/vsftpd
-      - run: docker run -p 1080:1080 -p 1025:1025 -d --name maildev soulteary/maildev
-      - run: docker run -p 6379:6379 -d --name redis redis
-      - run: docker run -p 5432:5432 --name postgres -e POSTGRES_PASSWORD=postgres -e POSTGRES_DB=postgres -e POSTGRES_PASSWORD=postgres -d postgis/postgis
-      - run: docker run -d -p 11300:11300 schickling/beanstalkd
+      - name: Set Docker containers
+        run: docker compose up -d
+
+      - name: Wait for MySQL to be ready
+        run: |
+          echo "Waiting for MySQL to be ready..."
+          for i in {1..30}; do
+            if docker exec bowphp_mysql mysqladmin ping -h localhost -u root -ppassword --silent 2>/dev/null; then
+              echo "MySQL is ready!"
+              break
+            fi
+            echo "Waiting for MySQL... ($i/30)"
+            sleep 2
+          done
+
+      - name: Wait for PostgreSQL to be ready
+        run: |
+          echo "Waiting for PostgreSQL to be ready..."
+          for i in {1..30}; do
+            if docker exec bowphp_postgres pg_isready -U postgres --silent 2>/dev/null; then
+              echo "PostgreSQL is ready!"
+              break
+            fi
+            echo "Waiting for PostgreSQL... ($i/30)"
+            sleep 2
+          done
 
       - name: Cache Composer packages
         id: composer-cache
-        uses: actions/cache@v2
+        uses: actions/cache@v4
         with:
           path: vendor
           key: ${{ runner.os }}-php-${{ hashFiles('**/composer.lock') }}
@@ -67,4 +78,4 @@ jobs:
         run: if [ ! -d /tmp/bowphp_testing ]; then mkdir -p /tmp/bowphp_testing; fi;
 
       - name: Run test suite
-        run: sudo composer run-script test
+        run: ./vendor/bin/phpunit tests --configuration phpunit.dist.xml

.gitignore

@@ -1,10 +1,12 @@
-tests/data/database.sqlite
-tests/data/cache/**
-vendor
-phpunit.xml
-.idea
-.DS_Store
-.env.json
-composer.lock
-.phpunit.result.cache
-bob
+tests/data/database.sqlite
+tests/data/cache/**
+vendor
+phpunit.xml
+.idea
+.DS_Store
+.env.json
+composer.lock
+.phpunit.result.cache
+bob
+.phpunit.cache
+.vscode/

CHANGELOG.md

@@ -5,6 +5,134 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 5.2.91 - 2026-03-28
+
+### What's Changed
+
+* Refactoring magic method definition by @papac in https://github.com/bowphp/framework/pull/372
+* Update CHANGELOG by @papac in https://github.com/bowphp/framework/pull/373
+
+**Full Changelog**: https://github.com/bowphp/framework/compare/5.2.90...5.2.91
+
+## 5.2.90 - 2026-03-20
+
+### What's Changed
+
+* Update CHANGELOG by @papac in https://github.com/bowphp/framework/pull/370
+* Fix query builder by @papac in https://github.com/bowphp/framework/pull/371
+
+**Full Changelog**: https://github.com/bowphp/framework/compare/5.2.8...5.2.90
+
+## 5.2.8 - 2026-03-20
+
+### What's Changed
+
+* Fix belongs to by @papac in https://github.com/bowphp/framework/pull/368
+* Update CHANGELOG by @papac in https://github.com/bowphp/framework/pull/369
+
+**Full Changelog**: https://github.com/bowphp/framework/compare/5.2.7...5.2.8
+
+## 5.2.7 - 2026-03-08
+
+### What's Changed
+
+* Add scheduler features by @papac in https://github.com/bowphp/framework/pull/365
+* Update CHANGELOG by @papac in https://github.com/bowphp/framework/pull/366
+* Add missing http methods by @papac in https://github.com/bowphp/framework/pull/367
+
+**Full Changelog**: https://github.com/bowphp/framework/compare/5.2.6...5.2.7
+
+## 5.2.6 - 2026-02-27
+
+### What's Changed
+
+* Fix domain definition by @papac in https://github.com/bowphp/framework/pull/363
+* Update CHANGELOG by @papac in https://github.com/bowphp/framework/pull/364
+
+**Full Changelog**: https://github.com/bowphp/framework/compare/5.2.5...5.2.6
+
+## 5.2.5 - 2026-02-27
+
+### What's Changed
+
+* Fix database, validation, add rabbitmq/kafka queue adapter by @papac in https://github.com/bowphp/framework/pull/362
+
+**Full Changelog**: https://github.com/bowphp/framework/compare/5.2.4...5.2.5
+
+## 5.2.3 - 2026-01-27
+
+### What's Changed
+
+* Refactoring queue adapter and add redis support by @papac in https://github.com/bowphp/framework/pull/358
+
+**Full Changelog**: https://github.com/bowphp/framework/compare/5.2.2...5.2.3
+
+## [Unreleased]
+
+### Added
+
+- **SMTP Adapter**: Complete rewrite with RFC-compliant SMTP protocol implementation
+
+  - Expanded from 8 to 21 methods for better functionality separation
+  - Added comprehensive configuration validation (hostname, port, timeout)
+  - Implemented multi-exception handling (SmtpException | SocketException)
+  - Enhanced email address parsing supporting "Name [email@example.com](mailto:email@example.com)" format
+  - Added optional authentication support
+  - Created comprehensive test suite with 21 tests and 35 assertions
+
+- **FTP Service**: Connection retry logic with 3 attempts and configurable delays
+
+- **FTP Service**: Configuration constants and validation for all required fields
+
+- **FTP Service**: Automatic stream cleanup with try-finally blocks
+
+- **FTP Service**: Destructor for proper resource cleanup
+
+- **Database Notifications**: Enhanced test coverage with 4 additional comprehensive tests
+
+- **Queue System**: Graceful logger fallback in BeanstalkdAdapter
+
+
+### Changed
+
+- **FTP Service**: Complete refactoring with improved error handling and resource management (651 lines)
+
+  - Enhanced all file operations methods (store, get, put, append, prepend, copy, move, delete)
+  - Improved directory operations (files, directories, makeDirectory)
+  - Better passive/active mode configuration
+  - More specific and actionable error messages
+  - Added connection state validation with `ensureConnection()` method
+
+- **Environment Configuration**: Fixed path handling by removing unreliable `realpath()` usage
+
+- **Configuration Loader**: Improved validation and error handling
+
+- **Notifier System**: Fixed PHPUnit mock issues and corrected type signatures
+
+- **Test Suite**: Renamed test methods to snake_case for consistency
+
+- **Database Tests**: Significantly expanded test coverage across connection, migration, pagination, and query builders
+
+
+### Fixed
+
+- **SMTP Adapter**: Port validation now correctly validates range (1-65535)
+- **SMTP Adapter**: Timeout validation now requires positive integers
+- **FTP Service**: Fixed directory listing parser to handle filenames with spaces
+- **FTP Service**: Improved error messages with connection details
+- **Environment Configuration**: Fixed `Env::configure()` error handling
+- **Queue Tests**: Fixed mock configuration issues in NotifierTest
+- **Notification Tests**: Added missing timestamp columns in test schema
+
+### Improved
+
+- **Test Coverage**: Added 29 new tests with 46 new assertions
+- **Error Rate**: Reduced test errors by 39% (28 → 17 errors)
+- **Failure Rate**: Reduced test failures by 70% (10 → 3 failures)
+- **Code Quality**: Better error messages across all refactored components
+- **Resource Management**: Proper cleanup prevents resource leaks
+- **Configuration Validation**: Early validation with specific error messages
+
 ## 5.1.7 - 2024-12-21
 
 ### What's Changed
@@ -24,7 +152,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## 5.1.2 - 2023-09-17
 
-Fix `db_seed` helper
+Fix `app_db_seed` helper
 
 Ref
 
@@ -43,6 +171,9 @@ Database::transaction(fn() => $user->update(['name' => '']));
 
 
 
+
+
+
 ```
 Ref: #255
 
@@ -63,16 +194,15 @@ Reference #248
 
 ## 5.0.8 - 2023-05-24
 
-Release 5.0.8
-
+Release **5.0.8**
 Fixes test case errors
 
 Reference #243
 From #242
 
 ## 5.0.7 - 2023-05-24
 
-Release 5.0.7
+Release **5.0.7**
 
 - Fixes the database relationship
 - Fixes the HTTP client
@@ -84,7 +214,7 @@ Fixes #240
 
 ## 5.0.6 - 2023-05-22
 
-Release 5.0.6
+Release **5.0.6**
 
 - Fixes get last insert id for pgsql
 - Add data validation custom message parser
@@ -98,7 +228,7 @@ References
 
 ## 5.0.5 - 2023-05-20
 
-Release 5.0.5
+Release **5.0.5**
 
 - Fix migration status table definition
 - Fix enum creation for pgsql
@@ -107,7 +237,7 @@ Reference #232
 
 ## 5.0.4 - 2023-05-19
 
-Release 5.0.4
+Release **5.0.4**
 
 - Fixes HTTP Client
 - Add variable binding to the env loader
@@ -127,15 +257,15 @@ Add many fixes
 
 ## 5.0.2 - 2023-05-16
 
-Release for 5.0.2
+Release **5.0.2**
 
 - Fix action dependency injector
 - Add the base error handler
 
 ## 5.0.0 - 2023-05-10
 
 - [Add] Convert the project from PHP7 to PHP8
-- [Add] Multiconnection for storage system
+- [Add] Multi connection for storage system
 - [Fix] Fixes migrations errors [#176](https://github.com/bowphp/framework/pull/176)
 - [Fix] Fixes the column size [#165](https://github.com/bowphp/framework/pull/165)
 - [Fix] Add the fallback on old request method [#170](https://github.com/bowphp/framework/pull/170)

CODE_OF_CONDUCT.md

@@ -1,6 +1,8 @@
-Bow's code of conduct is derived from the Ruby Code of Conduct. Any breach of the code of conduct may be reported to Franck DAKIA (dakiafranck@gmail.com).
+Bow's code of conduct is derived from the Ruby Code of Conduct. Any breach of the code of conduct may be reported to
+Franck DAKIA (dakiafranck@gmail.com).
 
 - Participants will be tolerant of opposing points of view.
-- Participants must ensure that their language and actions are free from personal attacks and derogatory personal remarks.
+- Participants must ensure that their language and actions are free from personal attacks and derogatory personal
+  remarks.
 - By interpreting the words and actions of others, participants must always assume good intentions.
 - Behavior that can reasonably be considered harassment will not be tolerated.