Gitingest

Include files under: 50kb

Private Repository

Summary

Repository: jalallinux/php-pm2
Files analyzed: 24

Estimated tokens: 13.4k

Download

Directory Structure

Directory structure:

└── jalallinux-php-pm2/

    ├── README.md

    ├── CHANGELOG.md

    ├── composer.json

    ├── LICENSE.md

    ├── phpunit.xml.dist

    ├── .editorconfig

    ├── src/

    │   ├── helpers.php

    │   ├── Pm2.php

    │   └── Structure/

    │       ├── AxmActions.php

    │       ├── AxmDynamic.php

    │       ├── AxmMonitor.php

    │       ├── AxmOptions.php

    │       ├── Env.php

    │       ├── Monit.php

    │       ├── Pm2Env.php

    │       └── Process.php

    ├── tests/

    │   └── StructureTest.php

    └── .github/

        ├── dependabot.yml

        ├── FUNDING.yml

        ├── ISSUE_TEMPLATE/

        │   └── config.yml

        └── workflows/

            ├── dependabot-auto-merge.yml

            ├── fix-php-code-style-issues.yml

            ├── run-tests.yml

            └── update-changelog.yml

Files Content

================================================
FILE: README.md
================================================
<div align="center">

<a href="https://github.com/Unitech/pm2">  
    <p align="center"><img src=".github/pm2-logo.png" width="100%"></p>
</a> 

[![Latest Version on Packagist](https://img.shields.io/packagist/v/jalallinux/php-pm2.svg?style=flat-square)](https://packagist.org/packages/jalallinux/php-pm2)
[![Tests](https://github.com/jalallinux/php-pm2/actions/workflows/run-tests.yml/badge.svg?branch=main)](https://github.com/jalallinux/php-pm2/actions/workflows/run-tests.yml)
[![Total Downloads](https://img.shields.io/packagist/dt/jalallinux/php-pm2.svg?style=flat-square)](https://packagist.org/packages/jalallinux/php-pm2)

## Use and Manage **PM2** in php

</div>

## Installation

You can install the package via composer:

```bash
composer require jalallinux/php-pm2
```

## Usage

### Pm2

* Full name: \JalalLinuX\Pm2\Pm2

### list [:question:](https://pm2.keymetrics.io/docs/usage/quick-start/#list-managed-applications)
Fetch list all running applications
```php
pm2()->list(string $sortField = 'name', bool $desc = true): array<Process>
```

**Parameters:**

| Parameter | Type       | Description                                             |
|-----------|------------|---------------------------------------------------------|
| `sortField` | **string** | Sort field: `name, id, pid, memory, cpu, status, uptime` |
| `desc` | **bool**   | Sort order is descending |


---
### link [:question:]()
Connect your server to your dashboard and start collecting metrics
```php
pm2()->link(string $publicKey, string $secretKey, string|null $machineName = null): bool
```

**Parameters:**

| Parameter | Type        | Description                   |
|-----------|-------------|-------------------------------|
| `publicKey` | **string**  | PM2 account `PUBLIC_KEY` |
| `secretKey` | **string**  | PM2 account `SECRET_KEY` |
| `machineName` | **?string** | Machine name on the dashboard |

---
### unlink [:question:]()
Disconnect your server from your metrics dashboard
```php
pm2()->unlink(): bool
```

---
### start [:question:](https://pm2.keymetrics.io/docs/usage/quick-start/#start-an-app)
Start command with specifics options or start a `ecosystem.config.js`
```php
pm2()->start(string $command = null, array $options = []): bool
```

**Parameters:**

| Parameter | Type       | Description |
|-----------|------------|-------------|
| `command` | **?string** | Command to run in pm2 |
| `options` | **array** | Options to start pm2 command [Guide](https://pm2.keymetrics.io/docs/usage/quick-start/#start-an-app) like `['name' => 'process-1', 'no-autorestart']` |

---
### findBy [:question:](https://pm2.keymetrics.io/docs/usage/process-management/#showing-application-metadata)
Find specific process
```php
pm2()->findBy(string $key, string $value): \JalalLinuX\Pm2\Structure\Process|null
```

**Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| `key` | **string** | Key of property to find process |
| `value` | **string** | Value of key |

---
### kill
kill daemon
```php
pm2()->kill(): bool
```

---
### pid
Fetch pid of specific process
```php
pm2()->pid(string $name): int|null
```

**Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| `name` | **string** | Name of process |

---
### flush [:question:](https://pm2.keymetrics.io/docs/usage/log-management/#flushing-logs)
Empty all log files
```php
pm2()->flush(): bool
```

---
### update [:question:](https://pm2.keymetrics.io/docs/usage/update-pm2/#process-to-update-pm2)
Update in memory pm2
```php
pm2()->update(): mixed
```

---
### stopAll [:question:](https://pm2.keymetrics.io/docs/usage/process-management/#stop)
Stop all processes
```php
pm2()->stopAll(): bool
```

---
### restartAll [:question:](https://pm2.keymetrics.io/docs/usage/process-management/#restart)
Restart all processes
```php
pm2()->restartAll(): bool
```

---
### deleteAll [:question:](https://pm2.keymetrics.io/docs/usage/process-management/#delete)
Will stop and delete all processes from pm2 list
```php
pm2()->deleteAll(): bool
```

---
### stop [:question:](https://pm2.keymetrics.io/docs/usage/process-management/#stop)
Stop specific process
```php
pm2()->stop(string $idOrName): bool
```

**Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| `idOrName` | **string** | Id or name of process|

---
### restart [:question:](https://pm2.keymetrics.io/docs/usage/process-management/#restart)
Restart specific process
```php
pm2()->restart(string $idOrName): bool
```

**Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| `idOrName` | **string** | Id or name of process|

---
### delete [:question:](https://pm2.keymetrics.io/docs/usage/process-management/#delete)
Delete specific process
```php
pm2()->delete(string $idOrName): bool
```

**Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| `idOrName` | **string** | Id or name of process |

---
### save [:question:](https://pm2.keymetrics.io/docs/usage/startup/#saving-the-app-list-to-be-restored-at-reboot)
Freeze a process list for automatic respawn
```php
pm2()->save(bool $force = true): bool
```

**Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| `force` | **bool** | Force save list |

---
### logOut [:question:](https://pm2.keymetrics.io/docs/usage/log-management/#log-views)
Display all processes output logs
```php
pm2()->logOut(string $idOrName = null, int $lines = 100): string
```

**Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| `idOrName` | **?string** | Id or name of process |
| `lines` | **int** | To dig in older logs |

---
### logErr [:question:](https://pm2.keymetrics.io/docs/usage/log-management/#log-views)
Display all processes error logs
```php
pm2()->logErr(string $idOrName = null, int $lines = 100): string
```

**Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| `idOrName` | **?string** | Id or name of process |
| `lines` | **int** | To dig in older logs |

---
### startup [:question:](https://pm2.keymetrics.io/docs/usage/quick-start/#setup-startup-script)
Generate an active startup script
```php
pm2()->startup(): bool
```

---
### version [:question:]()
Fetch installed pm2 version
```php
pm2()->version(): string
```

---
### install [:question:](https://pm2.keymetrics.io/docs/usage/update-pm2/#process-to-update-pm2)
Install **PM2** (Requirements: `node`, `npm`)
```php
pm2()->install(string $version = 'latest'): false|string|null
```

**Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| `version` | **string** | Specific version |

---
### isInstall
Check if the **PM2** is installed
```php
pm2()->isInstall(bool $forceInstall = false, string $version = 'latest'): bool
```

**Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| `forceInstall` | **bool** | Install pm2 if is not installed |
| `version` | **string** | Specific version |


## Testing

```bash
composer test
```

## Changelog

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

## Credits

- [JalalLinuX](https://github.com/jalallinux)
- [All Contributors](../../contributors)

## License

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.



================================================
FILE: CHANGELOG.md
================================================
# Changelog

All notable changes to `php-pm2` will be documented in this file.




================================================
FILE: composer.json
================================================
{
    "name": "jalallinux/php-pm2",
    "description": "Manage pm2 process in php",
    "keywords": [
        "jalallinux",
        "php-pm2"
    ],
    "homepage": "https://github.com/jalallinux/php-pm2",
    "license": "MIT",
    "authors": [
        {
            "name": "JalalLinuX",
            "email": "smjjalalzadeh93@gmail.com",
            "role": "Developer"
        }
    ],
    "require": {
        "php": "^7.4|^8.0|^8.1|^8.2",
        "ext-json": "*"
    },
    "require-dev": {
        "pestphp/pest": "^1.20",
        "spatie/ray": "^1.28"
    },
    "autoload": {
        "psr-4": {
            "JalalLinuX\\Pm2\\": "src"
        },
        "files": [
            "src/helpers.php"
        ]
    },
    "autoload-dev": {
        "psr-4": {
            "JalalLinuX\\Pm2\\Tests\\": "tests"
        }
    },
    "scripts": {
        "test": "vendor/bin/pest",
        "test-coverage": "vendor/bin/pest --coverage"
    },
    "config": {
        "sort-packages": true,
        "allow-plugins": {
            "phpstan/extension-installer": true,
            "pestphp/pest-plugin": true
        }
    },
    "minimum-stability": "dev",
    "prefer-stable": true
}



================================================
FILE: LICENSE.md
================================================
The MIT License (MIT)

Copyright (c) jalallinux <smjjalalzadeh93@gmail.com>

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.



================================================
FILE: phpunit.xml.dist
================================================
<?xml version="1.0" encoding="UTF-8"?>
<phpunit
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
    backupGlobals="false"
    backupStaticAttributes="false"
    bootstrap="vendor/autoload.php"
    colors="true"
    convertErrorsToExceptions="true"
    convertNoticesToExceptions="true"
    convertWarningsToExceptions="true"
    processIsolation="false"
    stopOnFailure="false"
    executionOrder="random"
    failOnWarning="true"
    failOnRisky="true"
    failOnEmptyTestSuite="true"
    beStrictAboutOutputDuringTests="true"
    verbose="true"
>
    <testsuites>
        <testsuite name="JalalLinuX Test Suite">
            <directory>tests</directory>
        </testsuite>
    </testsuites>
    <coverage>
        <include>
            <directory suffix=".php">./src</directory>
        </include>
        <report>
            <html outputDirectory="build/coverage"/>
            <text outputFile="build/coverage.txt"/>
            <clover outputFile="build/logs/clover.xml"/>
        </report>
    </coverage>
    <logging>
        <junit outputFile="build/report.junit.xml"/>
    </logging>
</phpunit>



================================================
FILE: .editorconfig
================================================
root = true

[*]
charset = utf-8
indent_size = 4
indent_style = space
end_of_line = lf
insert_final_newline = true
trim_trailing_whitespace = true

[*.md]
trim_trailing_whitespace = false

[*.{yml,yaml}]
indent_size = 2



================================================
FILE: src/helpers.php
================================================
<?php

use JalalLinuX\Pm2\Pm2;

if (! function_exists('pm2')) {
    function pm2(string $prefix = null): Pm2
    {
        return new Pm2($prefix);
    }
}

if (! function_exists('strBetween')) {
    function strBetween($string, $start, $end)
    {
        $string = ' '.$string;
        $ini = strpos($string, $start);
        if ($ini == 0) {
            return '';
        }
        $ini += strlen($start);
        $len = strpos($string, $end, $ini) - $ini;

        return substr($string, $ini, $len);
    }
}



================================================
FILE: src/Pm2.php
================================================
<?php

namespace JalalLinuX\Pm2;

use JalalLinuX\Pm2\Structure\Process;

class Pm2
{
    private ?string $prefix;

    public function __construct(string $prefix = null)
    {
        $this->prefix = $prefix;
    }

    /**
     * @return array<Process>
     */
    public function list(string $sortField = 'name', bool $desc = true): array
    {
        return array_map(static fn ($rec) => Process::fromJson($rec), $this->json($sortField, $desc));
    }

    public function link(string $publicKey, string $secretKey, string $machineName = null): bool
    {
        $result = $this->runCommand("link {$secretKey} {$publicKey} {$machineName} --update-env");

        return strpos($result, 'activated!') !== false;
    }

    public function unlink(): bool
    {
        $result = $this->runCommand('link delete --update-env');

        return strpos($result, 'ended') !== false;
    }

    public function start(string $command = null, array $options = []): bool
    {
        $options = $this->makeOptions($options);

        return ! is_null($this->runCommand('start'.(! is_null($command) ? " \"{$command}\" {$options} --update-env" : '')));
    }

    public function findBy(string $key, string $value): ?Process
    {
        foreach ($this->list() as $item) {
            if ($item->{$key} == $value) {
                return $item;
            }
        }

        return null;
    }

    public function kill(): bool
    {
        return ! is_null($this->runCommand('kill --update-env'));
    }

    public function pid(string $name): ?int
    {
        foreach ($this->list() as $item) {
            if ($item->name == $name) {
                return intval($item->pid);
            }
        }

        return null;
    }

    public function flush(): bool
    {
        return ! is_null($this->runCommand('flush --update-env'));
    }

    /**
     * @return mixed
     */
    public function update()
    {
        return $this->runCommand('update --update-env');
    }

    public function stopAll(): bool
    {
        if (! is_null($this->runCommand('stop all --update-env'))) {
            $this->save();

            return true;
        }

        return false;
    }

    public function restartAll(): bool
    {
        if (! is_null($this->runCommand('restart all --update-env'))) {
            $this->save();

            return true;
        }

        return false;
    }

    public function deleteAll(): bool
    {
        if (! is_null($this->runCommand('del all --update-env'))) {
            $this->save();

            return true;
        }

        return false;
    }

    public function stop(string $idOrName): bool
    {
        return ! is_null($this->runCommand("stop {$idOrName} --update-env"));
    }

    public function restart(string $idOrName): bool
    {
        return ! is_null($this->runCommand("restart {$idOrName} --update-env"));
    }

    public function delete(string $idOrName): bool
    {
        return ! is_null($this->runCommand("delete {$idOrName} --update-env"));
    }

    public function save(bool $force = true): bool
    {
        return ! is_null($this->runCommand('save'.($force ? ' --force' : '')));
    }

    public function logOut(string $idOrName = null, int $lines = 100): string
    {
        return $this->runCommand('logs'.(! is_null($idOrName) ? " {$idOrName}" : '')." --lines={$lines} --nostream --raw --out");
    }

    public function logErr(string $idOrName = null, int $lines = 100): string
    {
        return $this->runCommand('logs'.(! is_null($idOrName) ? " {$idOrName}" : '')." --lines={$lines} --nostream --raw --err");
    }

    public function startup(): bool
    {
        $this->runCommand('startup --update-env');

        return $this->save();
    }

    public function version(): string
    {
        return trim($this->runCommand('--version'));
    }

    /**
     * @return false|string|null
     */
    public function install(string $version = 'latest')
    {
        return shell_exec("npm install -g pm2@{$version}");
    }

    public function isInstall(bool $forceInstall = false, string $version = 'latest'): bool
    {
        $isInstall = ! is_null($this->runCommand('--version'));
        if (! $isInstall && $forceInstall) {
            $this->install($version);

            return $this->isInstall();
        }

        return $isInstall;
    }

    protected function makeOptions(array $options): string
    {
        return implode(' ', array_map(function ($k, $v) {
            return is_int($k) ? "--{$v}" : "--{$k}={$v}";
        }, array_keys($options), $options));
    }

    protected function json(string $sortField, bool $desc = true): array
    {
        return json_decode($this->runCommand("jlist --sort {$sortField}:".($desc ? 'desc' : 'asc')), true) ?? [];
    }

    protected function runCommand(string $command)
    {
        return shell_exec(trim("{$this->prefix} pm2 {$command}"));
    }
}



================================================
FILE: src/Structure/AxmActions.php
================================================
<?php

namespace JalalLinuX\Pm2\Structure;

final class AxmActions
{
    public ?array $data;

    public static function fromJson(array $data): self
    {
        $instance = new self();
        $instance->data = $data;

        return $instance;
    }
}



================================================
FILE: src/Structure/AxmDynamic.php
================================================
<?php

namespace JalalLinuX\Pm2\Structure;

final class AxmDynamic
{
    public ?array $data;

    public static function fromJson(array $data): self
    {
        $instance = new self();
        $instance->data = $data;

        return $instance;
    }
}



================================================
FILE: src/Structure/AxmMonitor.php
================================================
<?php

namespace JalalLinuX\Pm2\Structure;

final class AxmMonitor
{
    public ?array $data;

    public static function fromJson(array $data): self
    {
        $instance = new self();
        $instance->data = $data;

        return $instance;
    }
}



================================================
FILE: src/Structure/AxmOptions.php
================================================
<?php

namespace JalalLinuX\Pm2\Structure;

final class AxmOptions
{
    public ?array $data;

    public static function fromJson(array $data): self
    {
        $instance = new self();
        $instance->data = $data;

        return $instance;
    }
}



================================================
FILE: src/Structure/Env.php
================================================
<?php

namespace JalalLinuX\Pm2\Structure;

final class Env
{
    public ?string $uniqueId;

    public ?string $pm2Home;

    public ?string $shell;

    public ?string $sessionManager;

    public ?string $qtAccessibility;

    public ?string $snapRevision;

    public ?string $xdgConfigDirs;

    public ?string $xdgMenuPrefix;

    public ?string $gnomeDesktopSessionId;

    public ?string $snapRealHome;

    public ?string $terminalEmulator;

    public ?string $snapUserCommon;

    public ?string $lcAddress;

    public ?string $gnomeShellSessionMode;

    public ?string $lcName;

    public ?string $sshAuthSock;

    public ?string $termSessionId;

    public ?string $snapInstanceKey;

    public ?string $xmodifiers;

    public ?string $desktopSession;

    public ?string $lcMonetary;

    public ?string $sshAgentPid;

    public ?string $bamfDesktopFileHint;

    public ?string $gtkModules;

    public ?string $pwd;

    public ?string $xdgSessionDesktop;

    public ?string $logname;

    public ?string $xdgSessionType;

    public ?string $gpgAgentInfo;

    public ?string $xauthority;

    public ?string $desktopStartupId;

    public ?string $snapContext;

    public ?string $gjsDebugTopics;

    public ?string $windowpath;

    public ?string $home;

    public ?string $username;

    public ?string $imConfigPhase;

    public ?string $lang;

    public ?string $lcPaper;

    public ?string $lsColors;

    public ?string $xdgCurrentDesktop;

    public ?string $snapArch;

    public ?string $snapInstanceName;

    public ?string $snapUserData;

    public ?string $compWordbreaks;

    public ?string $invocationId;

    public ?string $managerpid;

    public ?string $snapReexec;

    public ?string $gjsDebugOutput;

    public ?string $lessclose;

    public ?string $xdgSessionClass;

    public ?string $term;

    public ?string $lcIdentification;

    public ?string $lessopen;

    public ?string $user;

    public ?string $snap;

    public ?string $snapCommon;

    public ?string $snapVersion;

    public ?string $display;

    public ?string $shlvl;

    public ?string $snapLibraryPath;

    public ?string $snapCookie;

    public ?string $lcTelephone;

    public ?string $qtImModule;

    public ?string $lcMeasurement;

    public ?string $snapData;

    public ?string $xdgRuntimeDir;

    public ?string $lcTime;

    public ?string $snapName;

    public ?string $journalStream;

    public ?string $xdgDataDirs;

    public ?string $path;

    public ?string $gdmsession;

    public ?string $dbusSessionBusAddress;

    public ?string $gioLaunchedDesktopFilePid;

    public ?string $gioLaunchedDesktopFile;

    public ?string $lcNumeric;

    public ?string $_;

    public ?string $pm2Usage;

    public static function fromJson(array $data): self
    {
        $instance = new self();
        $instance->uniqueId = $data['unique_id'] ?? null;
        $instance->pm2Home = $data['PM2_HOME'] ?? null;
        $instance->shell = $data['SHELL'] ?? null;
        $instance->sessionManager = $data['SESSION_MANAGER'] ?? null;
        $instance->qtAccessibility = $data['QT_ACCESSIBILITY'] ?? null;
        $instance->snapRevision = $data['SNAP_REVISION'] ?? null;
        $instance->xdgConfigDirs = $data['XDG_CONFIG_DIRS'] ?? null;
        $instance->xdgMenuPrefix = $data['XDG_MENU_PREFIX'] ?? null;
        $instance->gnomeDesktopSessionId = $data['GNOME_DESKTOP_SESSION_ID'] ?? null;
        $instance->snapRealHome = $data['SNAP_REAL_HOME'] ?? null;
        $instance->terminalEmulator = $data['TERMINAL_EMULATOR'] ?? null;
        $instance->snapUserCommon = $data['SNAP_USER_COMMON'] ?? null;
        $instance->lcAddress = $data['LC_ADDRESS'] ?? null;
        $instance->gnomeShellSessionMode = $data['GNOME_SHELL_SESSION_MODE'] ?? null;
        $instance->lcName = $data['LC_NAME'] ?? null;
        $instance->sshAuthSock = $data['SSH_AUTH_SOCK'] ?? null;
        $instance->termSessionId = $data['TERM_SESSION_ID'] ?? null;
        $instance->snapInstanceKey = $data['SNAP_INSTANCE_KEY'] ?? null;
        $instance->xmodifiers = $data['XMODIFIERS'] ?? null;
        $instance->desktopSession = $data['DESKTOP_SESSION'] ?? null;
        $instance->lcMonetary = $data['LC_MONETARY'] ?? null;
        $instance->sshAgentPid = $data['SSH_AGENT_PID'] ?? null;
        $instance->bamfDesktopFileHint = $data['BAMF_DESKTOP_FILE_HINT'] ?? null;
        $instance->gtkModules = $data['GTK_MODULES'] ?? null;
        $instance->pwd = $data['PWD'] ?? null;
        $instance->xdgSessionDesktop = $data['XDG_SESSION_DESKTOP'] ?? null;
        $instance->logname = $data['LOGNAME'] ?? null;
        $instance->xdgSessionType = $data['XDG_SESSION_TYPE'] ?? null;
        $instance->gpgAgentInfo = $data['GPG_AGENT_INFO'] ?? null;
        $instance->xauthority = $data['XAUTHORITY'] ?? null;
        $instance->desktopStartupId = $data['DESKTOP_STARTUP_ID'] ?? null;
        $instance->snapContext = $data['SNAP_CONTEXT'] ?? null;
        $instance->gjsDebugTopics = $data['GJS_DEBUG_TOPICS'] ?? null;
        $instance->windowpath = $data['WINDOWPATH'] ?? null;
        $instance->home = $data['HOME'] ?? null;
        $instance->username = $data['USERNAME'] ?? null;
        $instance->imConfigPhase = $data['IM_CONFIG_PHASE'] ?? null;
        $instance->lang = $data['LANG'] ?? null;
        $instance->lcPaper = $data['LC_PAPER'] ?? null;
        $instance->lsColors = $data['LS_COLORS'] ?? null;
        $instance->xdgCurrentDesktop = $data['XDG_CURRENT_DESKTOP'] ?? null;
        $instance->snapArch = $data['SNAP_ARCH'] ?? null;
        $instance->snapInstanceName = $data['SNAP_INSTANCE_NAME'] ?? null;
        $instance->snapUserData = $data['SNAP_USER_DATA'] ?? null;
        $instance->compWordbreaks = $data['COMP_WORDBREAKS'] ?? null;
        $instance->invocationId = $data['INVOCATION_ID'] ?? null;
        $instance->managerpid = $data['MANAGERPID'] ?? null;
        $instance->snapReexec = $data['SNAP_REEXEC'] ?? null;
        $instance->gjsDebugOutput = $data['GJS_DEBUG_OUTPUT'] ?? null;
        $instance->lessclose = $data['LESSCLOSE'] ?? null;
        $instance->xdgSessionClass = $data['XDG_SESSION_CLASS'] ?? null;
        $instance->term = $data['TERM'] ?? null;
        $instance->lcIdentification = $data['LC_IDENTIFICATION'] ?? null;
        $instance->lessopen = $data['LESSOPEN'] ?? null;
        $instance->user = $data['USER'] ?? null;
        $instance->snap = $data['SNAP'] ?? null;
        $instance->snapCommon = $data['SNAP_COMMON'] ?? null;
        $instance->snapVersion = $data['SNAP_VERSION'] ?? null;
        $instance->display = $data['DISPLAY'] ?? null;
        $instance->shlvl = $data['SHLVL'] ?? null;
        $instance->snapLibraryPath = $data['SNAP_LIBRARY_PATH'] ?? null;
        $instance->snapCookie = $data['SNAP_COOKIE'] ?? null;
        $instance->lcTelephone = $data['LC_TELEPHONE'] ?? null;
        $instance->qtImModule = $data['QT_IM_MODULE'] ?? null;
        $instance->lcMeasurement = $data['LC_MEASUREMENT'] ?? null;
        $instance->snapData = $data['SNAP_DATA'] ?? null;
        $instance->xdgRuntimeDir = $data['XDG_RUNTIME_DIR'] ?? null;
        $instance->lcTime = $data['LC_TIME'] ?? null;
        $instance->snapName = $data['SNAP_NAME'] ?? null;
        $instance->journalStream = $data['JOURNAL_STREAM'] ?? null;
        $instance->xdgDataDirs = $data['XDG_DATA_DIRS'] ?? null;
        $instance->path = $data['PATH'] ?? null;
        $instance->gdmsession = $data['GDMSESSION'] ?? null;
        $instance->dbusSessionBusAddress = $data['DBUS_SESSION_BUS_ADDRESS'] ?? null;
        $instance->gioLaunchedDesktopFilePid = $data['GIO_LAUNCHED_DESKTOP_FILE_PID'] ?? null;
        $instance->gioLaunchedDesktopFile = $data['GIO_LAUNCHED_DESKTOP_FILE'] ?? null;
        $instance->lcNumeric = $data['LC_NUMERIC'] ?? null;
        $instance->_ = $data['_'] ?? null;
        $instance->pm2Usage = $data['PM2_USAGE'] ?? null;

        return $instance;
    }
}



================================================
FILE: src/Structure/Monit.php
================================================
<?php

namespace JalalLinuX\Pm2\Structure;

final class Monit
{
    public ?int $memory;

    public ?int $cpu;

    public static function fromJson(array $data): self
    {
        $instance = new self();
        $instance->memory = $data['memory'] ?? null;
        $instance->cpu = $data['cpu'] ?? null;

        return $instance;
    }
}



================================================
FILE: src/Structure/Pm2Env.php
================================================
<?php

namespace JalalLinuX\Pm2\Structure;

final class Pm2Env
{
    public ?int $exitCode;

    public $versioning;

    public ?string $version;

    public ?int $unstableRestarts;

    public ?int $restartTime;

    public ?int $pmId;

    public $createdAt;

    public ?AxmDynamic $axmDynamic;

    public ?AxmOptions $axmOptions;

    public ?AxmMonitor $axmMonitor;

    public ?array $axmActions;

    public ?int $pmUptime;

    public ?string $status;

    public ?string $uniqueId;

    public ?string $pm2Home;

    public ?string $shell;

    public ?string $sessionManager;

    public ?string $qtAccessibility;

    public ?string $snapRevision;

    public ?string $xdgConfigDirs;

    public ?string $xdgMenuPrefix;

    public ?string $gnomeDesktopSessionId;

    public ?string $snapRealHome;

    public ?string $terminalEmulator;

    public ?string $snapUserCommon;

    public ?string $lcAddress;

    public ?string $gnomeShellSessionMode;

    public ?string $lcName;

    public ?string $sshAuthSock;

    public ?string $termSessionId;

    public ?string $snapInstanceKey;

    public ?string $xmodifiers;

    public ?string $desktopSession;

    public ?string $lcMonetary;

    public ?string $sshAgentPid;

    public ?string $bamfDesktopFileHint;

    public ?string $gtkModules;

    public ?string $pwd;

    public ?string $xdgSessionDesktop;

    public ?string $logname;

    public ?string $xdgSessionType;

    public ?string $gpgAgentInfo;

    public ?string $xauthority;

    public ?string $desktopStartupId;

    public ?string $snapContext;

    public ?string $gjsDebugTopics;

    public ?string $windowpath;

    public ?string $home;

    public ?string $username;

    public ?string $imConfigPhase;

    public ?string $lang;

    public ?string $lcPaper;

    public ?string $lsColors;

    public ?string $xdgCurrentDesktop;

    public ?string $snapArch;

    public ?string $snapInstanceName;

    public ?string $snapUserData;

    public ?string $compWordbreaks;

    public ?string $invocationId;

    public ?string $managerpid;

    public ?string $snapReexec;

    public ?string $gjsDebugOutput;

    public ?string $lessclose;

    public ?string $xdgSessionClass;

    public ?string $term;

    public ?string $lcIdentification;

    public ?string $lessopen;

    public ?string $user;

    public ?string $snap;

    public ?string $snapCommon;

    public ?string $snapVersion;

    public ?string $display;

    public ?string $shlvl;

    public ?string $snapLibraryPath;

    public ?string $snapCookie;

    public ?string $lcTelephone;

    public ?string $qtImModule;

    public ?string $lcMeasurement;

    public ?string $snapData;

    public ?string $xdgRuntimeDir;

    public ?string $lcTime;

    public ?string $snapName;

    public ?string $journalStream;

    public ?string $xdgDataDirs;

    public ?string $path;

    public ?string $gdmsession;

    public ?string $dbusSessionBusAddress;

    public ?string $gioLaunchedDesktopFilePid;

    public ?string $gioLaunchedDesktopFile;

    public ?string $lcNumeric;

    public ?string $_;

    public ?string $pm2Usage;

    public ?int $nodeAppInstance;

    public ?bool $vizionRunning;

    public ?bool $kmLink;

    public ?string $pmPidPath;

    public ?string $pmErrLogPath;

    public ?string $pmOutLogPath;

    public ?int $instances;

    public ?string $execMode;

    public ?string $execInterpreter;

    public ?string $pmCwd;

    public ?string $pmExecPath;

    public ?array $nodeArgs;

    public ?string $name;

    public ?array $filterEnv;

    public ?string $namespace;

    /** @var string[]|null */
    public ?array $args;

    public ?Env $env;

    public ?bool $mergeLogs;

    public ?bool $vizion;

    public ?bool $autorestart;

    public ?bool $watch;

    public ?string $instanceVar;

    public ?bool $pmx;

    public ?bool $automation;

    public ?bool $treekill;

    public ?bool $windowsHide;

    public ?int $killRetryTime;

    public static function fromJson(array $data): self
    {
        $instance = new self();
        $instance->exitCode = $data['exit_code'] ?? null;
        $instance->versioning = $data['versioning'] ?? null;
        $instance->version = $data['version'] ?? null;
        $instance->unstableRestarts = $data['unstable_restarts'] ?? null;
        $instance->restartTime = $data['restart_time'] ?? null;
        $instance->pmId = $data['pm_id'] ?? null;
        $instance->createdAt = $data['created_at'] ?? null;
        $instance->axmDynamic = ($data['axm_dynamic'] ?? null) !== null ? AxmDynamic::fromJson($data['axm_dynamic']) : null;
        $instance->axmOptions = ($data['axm_options'] ?? null) !== null ? AxmOptions::fromJson($data['axm_options']) : null;
        $instance->axmMonitor = ($data['axm_monitor'] ?? null) !== null ? AxmMonitor::fromJson($data['axm_monitor']) : null;
        $instance->axmActions = $data['axm_actions'] ?? null;
        $instance->pmUptime = $data['pm_uptime'] ?? null;
        $instance->status = $data['status'] ?? null;
        $instance->uniqueId = $data['unique_id'] ?? null;
        $instance->pm2Home = $data['PM2_HOME'] ?? null;
        $instance->shell = $data['SHELL'] ?? null;
        $instance->sessionManager = $data['SESSION_MANAGER'] ?? null;
        $instance->qtAccessibility = $data['QT_ACCESSIBILITY'] ?? null;
        $instance->snapRevision = $data['SNAP_REVISION'] ?? null;
        $instance->xdgConfigDirs = $data['XDG_CONFIG_DIRS'] ?? null;
        $instance->xdgMenuPrefix = $data['XDG_MENU_PREFIX'] ?? null;
        $instance->gnomeDesktopSessionId = $data['GNOME_DESKTOP_SESSION_ID'] ?? null;
        $instance->snapRealHome = $data['SNAP_REAL_HOME'] ?? null;
        $instance->terminalEmulator = $data['TERMINAL_EMULATOR'] ?? null;
        $instance->snapUserCommon = $data['SNAP_USER_COMMON'] ?? null;
        $instance->lcAddress = $data['LC_ADDRESS'] ?? null;
        $instance->gnomeShellSessionMode = $data['GNOME_SHELL_SESSION_MODE'] ?? null;
        $instance->lcName = $data['LC_NAME'] ?? null;
        $instance->sshAuthSock = $data['SSH_AUTH_SOCK'] ?? null;
        $instance->termSessionId = $data['TERM_SESSION_ID'] ?? null;
        $instance->snapInstanceKey = $data['SNAP_INSTANCE_KEY'] ?? null;
        $instance->xmodifiers = $data['XMODIFIERS'] ?? null;
        $instance->desktopSession = $data['DESKTOP_SESSION'] ?? null;
        $instance->lcMonetary = $data['LC_MONETARY'] ?? null;
        $instance->sshAgentPid = $data['SSH_AGENT_PID'] ?? null;
        $instance->bamfDesktopFileHint = $data['BAMF_DESKTOP_FILE_HINT'] ?? null;
        $instance->gtkModules = $data['GTK_MODULES'] ?? null;
        $instance->pwd = $data['PWD'] ?? null;
        $instance->xdgSessionDesktop = $data['XDG_SESSION_DESKTOP'] ?? null;
        $instance->logname = $data['LOGNAME'] ?? null;
        $instance->xdgSessionType = $data['XDG_SESSION_TYPE'] ?? null;
        $instance->gpgAgentInfo = $data['GPG_AGENT_INFO'] ?? null;
        $instance->xauthority = $data['XAUTHORITY'] ?? null;
        $instance->desktopStartupId = $data['DESKTOP_STARTUP_ID'] ?? null;
        $instance->snapContext = $data['SNAP_CONTEXT'] ?? null;
        $instance->gjsDebugTopics = $data['GJS_DEBUG_TOPICS'] ?? null;
        $instance->windowpath = $data['WINDOWPATH'] ?? null;
        $instance->home = $data['HOME'] ?? null;
        $instance->username = $data['USERNAME'] ?? null;
        $instance->imConfigPhase = $data['IM_CONFIG_PHASE'] ?? null;
        $instance->lang = $data['LANG'] ?? null;
        $instance->lcPaper = $data['LC_PAPER'] ?? null;
        $instance->lsColors = $data['LS_COLORS'] ?? null;
        $instance->xdgCurrentDesktop = $data['XDG_CURRENT_DESKTOP'] ?? null;
        $instance->snapArch = $data['SNAP_ARCH'] ?? null;
        $instance->snapInstanceName = $data['SNAP_INSTANCE_NAME'] ?? null;
        $instance->snapUserData = $data['SNAP_USER_DATA'] ?? null;
        $instance->compWordbreaks = $data['COMP_WORDBREAKS'] ?? null;
        $instance->invocationId = $data['INVOCATION_ID'] ?? null;
        $instance->managerpid = $data['MANAGERPID'] ?? null;
        $instance->snapReexec = $data['SNAP_REEXEC'] ?? null;
        $instance->gjsDebugOutput = $data['GJS_DEBUG_OUTPUT'] ?? null;
        $instance->lessclose = $data['LESSCLOSE'] ?? null;
        $instance->xdgSessionClass = $data['XDG_SESSION_CLASS'] ?? null;
        $instance->term = $data['TERM'] ?? null;
        $instance->lcIdentification = $data['LC_IDENTIFICATION'] ?? null;
        $instance->lessopen = $data['LESSOPEN'] ?? null;
        $instance->user = $data['USER'] ?? null;
        $instance->snap = $data['SNAP'] ?? null;
        $instance->snapCommon = $data['SNAP_COMMON'] ?? null;
        $instance->snapVersion = $data['SNAP_VERSION'] ?? null;
        $instance->display = $data['DISPLAY'] ?? null;
        $instance->shlvl = $data['SHLVL'] ?? null;
        $instance->snapLibraryPath = $data['SNAP_LIBRARY_PATH'] ?? null;
        $instance->snapCookie = $data['SNAP_COOKIE'] ?? null;
        $instance->lcTelephone = $data['LC_TELEPHONE'] ?? null;
        $instance->qtImModule = $data['QT_IM_MODULE'] ?? null;
        $instance->lcMeasurement = $data['LC_MEASUREMENT'] ?? null;
        $instance->snapData = $data['SNAP_DATA'] ?? null;
        $instance->xdgRuntimeDir = $data['XDG_RUNTIME_DIR'] ?? null;
        $instance->lcTime = $data['LC_TIME'] ?? null;
        $instance->snapName = $data['SNAP_NAME'] ?? null;
        $instance->journalStream = $data['JOURNAL_STREAM'] ?? null;
        $instance->xdgDataDirs = $data['XDG_DATA_DIRS'] ?? null;
        $instance->path = $data['PATH'] ?? null;
        $instance->gdmsession = $data['GDMSESSION'] ?? null;
        $instance->dbusSessionBusAddress = $data['DBUS_SESSION_BUS_ADDRESS'] ?? null;
        $instance->gioLaunchedDesktopFilePid = $data['GIO_LAUNCHED_DESKTOP_FILE_PID'] ?? null;
        $instance->gioLaunchedDesktopFile = $data['GIO_LAUNCHED_DESKTOP_FILE'] ?? null;
        $instance->lcNumeric = $data['LC_NUMERIC'] ?? null;
        $instance->_ = $data['_'] ?? null;
        $instance->pm2Usage = $data['PM2_USAGE'] ?? null;
        $instance->nodeAppInstance = $data['NODE_APP_INSTANCE'] ?? null;
        $instance->vizionRunning = $data['vizion_running'] ?? null;
        $instance->kmLink = $data['km_link'] ?? null;
        $instance->pmPidPath = $data['pm_pid_path'] ?? null;
        $instance->pmErrLogPath = $data['pm_err_log_path'] ?? null;
        $instance->pmOutLogPath = $data['pm_out_log_path'] ?? null;
        $instance->instances = $data['instances'] ?? null;
        $instance->execMode = $data['exec_mode'] ?? null;
        $instance->execInterpreter = $data['exec_interpreter'] ?? null;
        $instance->pmCwd = $data['pm_cwd'] ?? null;
        $instance->pmExecPath = $data['pm_exec_path'] ?? null;
        $instance->nodeArgs = $data['node_args'] ?? null;
        $instance->name = $data['name'] ?? null;
        $instance->filterEnv = $data['filter_env'] ?? null;
        $instance->namespace = $data['namespace'] ?? null;
        $instance->args = $data['args'] ?? null;
        $instance->env = ($data['env'] ?? null) !== null ? Env::fromJson($data['env']) : null;
        $instance->mergeLogs = $data['merge_logs'] ?? null;
        $instance->vizion = $data['vizion'] ?? null;
        $instance->autorestart = $data['autorestart'] ?? null;
        $instance->watch = $data['watch'] ?? null;
        $instance->instanceVar = $data['instance_var'] ?? null;
        $instance->pmx = $data['pmx'] ?? null;
        $instance->automation = $data['automation'] ?? null;
        $instance->treekill = $data['treekill'] ?? null;
        $instance->windowsHide = $data['windowsHide'] ?? null;
        $instance->killRetryTime = $data['kill_retry_time'] ?? null;

        return $instance;
    }
}



================================================
FILE: src/Structure/Process.php
================================================
<?php

namespace JalalLinuX\Pm2\Structure;

final class Process
{
    public ?int $pid;

    public ?string $name;

    public ?Pm2Env $pm2Env;

    public ?int $pmId;

    public ?Monit $monit;

    public static function fromJson(array $data): self
    {
        $instance = new self();
        $instance->pid = $data['pid'] ?? null;
        $instance->name = $data['name'] ?? null;
        $instance->pm2Env = ($data['pm2_env'] ?? null) !== null ? Pm2Env::fromJson($data['pm2_env']) : null;
        $instance->pmId = $data['pm_id'] ?? null;
        $instance->monit = ($data['monit'] ?? null) !== null ? Monit::fromJson($data['monit']) : null;

        return $instance;
    }

    public function start(array $options = []): bool
    {
        return pm2()->start($this->name, $options);
    }

    public function stop(): bool
    {
        return pm2()->stop($this->name);
    }

    public function restart(): bool
    {
        return pm2()->restart($this->name);
    }

    public function delete(): bool
    {
        return pm2()->delete($this->name);
    }

    public function logErr(int $lines = 100): string
    {
        return pm2()->logErr($this->name, $lines);
    }

    public function logOut(int $lines = 100): string
    {
        return pm2()->logOut($this->name, $lines);
    }
}



================================================
FILE: tests/StructureTest.php
================================================
<?php

use JalalLinuX\Pm2\Structure\Process;

const TEST_PROCESS_NAME_PREFIX = 'JalalLinuX-Test-Process-';

afterAll(function () {
    pm2()->delete('/'.TEST_PROCESS_NAME_PREFIX.'./');
    pm2()->save();
});

it('is list structure test', function () {
    if (pm2()->isInstall()) {
        expect(pm2()->list())
            ->toBeArray()
            ->each(fn ($item) => $item->toBeInstanceOf(Process::class));
    }
});

it('is startup test', function () {
    if (pm2()->isInstall()) {
        expect(pm2()->startup())->toBeTrue();
    }
});

it('is version test', function () {
    if (pm2()->isInstall()) {
        expect(pm2()->version())->toBeString();
    }
});

it('is install test', function () {
    if (pm2()->isInstall()) {
        expect(pm2()->isInstall())->toBeBool();
    }
});

it('is delete all test', function () {
    if (pm2()->isInstall()) {
        expect(pm2()->deleteAll())->toBeBool();
    }
});

it('is stop all test', function () {
    if (pm2()->isInstall()) {
        expect(pm2()->stopAll())->toBeBool();
    }
});

it('is restart all test', function () {
    if (pm2()->isInstall()) {
        expect(pm2()->restartAll())->toBeBool();
    }
});

it('is save test', function () {
    if (pm2()->isInstall()) {
        expect(pm2()->save())->toBeBool();
    }
});

it('is flush test', function () {
    if (pm2()->isInstall()) {
        expect(pm2()->flush())->toBeBool();
    }
});

it('is findBy test', function () {
    if (pm2()->isInstall()) {
        $name = TEST_PROCESS_NAME_PREFIX.uniqid();
        pm2()->start('ls -la', ['name' => $name, 'no-autorestart']);
        expect(pm2()->findBy('name', $name))->toBeInstanceOf(Process::class);
    }
});

it('is delete test', function () {
    if (pm2()->isInstall()) {
        $name = TEST_PROCESS_NAME_PREFIX.uniqid();
        pm2()->start('ls -la', ['name' => $name, 'no-autorestart']);
        expect(pm2()->delete($name))->toBeTrue();
    }
});

it('is stop test', function () {
    if (pm2()->isInstall()) {
        $name = TEST_PROCESS_NAME_PREFIX.uniqid();
        pm2()->start('ls -la', ['name' => $name, 'no-autorestart']);
        expect(pm2()->stop($name))->toBeTrue();
    }
});

it('is restart test', function () {
    if (pm2()->isInstall()) {
        $name = TEST_PROCESS_NAME_PREFIX.uniqid();
        pm2()->start('ls -la', ['name' => $name, 'no-autorestart']);
        expect(pm2()->restart($name))->toBeTrue();
    }
});

it('is pid test', function () {
    if (pm2()->isInstall()) {
        $name = TEST_PROCESS_NAME_PREFIX.uniqid();
        pm2()->start('ls -la', ['name' => $name, 'no-autorestart']);
        expect(pm2()->pid($name))->toBeInt();
    }
});

it('is link test', function () {
    if (pm2()->isInstall()) {
        $args = ['PUBLIC_KEY', 'SECRET_KEY', 'MACHINE_NAME'];
        expect(pm2()->link(...$args))->toBeBool();
    }
});

it('is unlink test', function () {
    if (pm2()->isInstall()) {
        expect(pm2()->unlink())->toBeBool();
    }
});

it('is logOut test', function () {
    if (pm2()->isInstall()) {
        $name = TEST_PROCESS_NAME_PREFIX.uniqid();
        pm2()->start('ls -la', ['name' => $name, 'no-autorestart']);
        expect(pm2()->logOut($name))->toBeString();
    }
});

it('is logErr test', function () {
    if (pm2()->isInstall()) {
        $name = TEST_PROCESS_NAME_PREFIX.uniqid();
        pm2()->start('ls -la', ['name' => $name, 'no-autorestart']);
        expect(pm2()->logErr($name))->toBeString();
    }
});

it('is kill test', function () {
    if (pm2()->isInstall()) {
        $name = TEST_PROCESS_NAME_PREFIX.uniqid();
        pm2()->start('ls -la', ['name' => $name, 'no-autorestart']);
        expect(pm2()->kill())->toBeTrue();
        expect(pm2()->list())->toBeArray()->toBeEmpty();
    }
});



================================================
FILE: .github/dependabot.yml
================================================
# Please see the documentation for all configuration options:
# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates

version: 2
updates:

  - package-ecosystem: "github-actions"
    directory: "/"
    schedule:
      interval: "weekly"
    labels:
      - "dependencies"


================================================
FILE: .github/FUNDING.yml
================================================
# These are supported funding model platforms

github: "jalallinux" # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
#patreon: # Replace with a single Patreon username
#open_collective: # Replace with a single Open Collective username
#ko_fi: # Replace with a single Ko-fi username
#tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
#community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
#liberapay: # Replace with a single Liberapay username
#issuehunt: # Replace with a single IssueHunt username
#otechie: # Replace with a single Otechie username
#lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry



================================================
FILE: .github/ISSUE_TEMPLATE/config.yml
================================================
blank_issues_enabled: false
contact_links:
    - name: Ask a question
      url: https://github.com/jalallinux/php-pm2/discussions/new?category=q-a
      about: Ask the community for help
    - name: Request a feature
      url: https://github.com/jalallinux/php-pm2/discussions/new?category=ideas
      about: Share ideas for new features
    - name: Report a security issue
      url: https://github.com/jalallinux/php-pm2/security/policy
      about: Learn how to notify us for sensitive bugs
    - name: Report a bug
      url: https://github.com/jalallinux/php-pm2/issues/new
      about: Report a reproducable bug



================================================
FILE: .github/workflows/dependabot-auto-merge.yml
================================================
name: dependabot-auto-merge
on: pull_request_target

permissions:
  pull-requests: write
  contents: write

jobs:
  dependabot:
    runs-on: ubuntu-latest
    if: ${{ github.actor == 'dependabot[bot]' }}
    steps:
    
      - name: Dependabot metadata
        id: metadata
        uses: dependabot/fetch-metadata@v1.6.0
        with:
          github-token: "${{ secrets.GITHUB_TOKEN }}"
          
      - name: Auto-merge Dependabot PRs for semver-minor updates
        if: ${{steps.metadata.outputs.update-type == 'version-update:semver-minor'}}
        run: gh pr merge --auto --merge "$PR_URL"
        env:
          PR_URL: ${{github.event.pull_request.html_url}}
          GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
          
      - name: Auto-merge Dependabot PRs for semver-patch updates
        if: ${{steps.metadata.outputs.update-type == 'version-update:semver-patch'}}
        run: gh pr merge --auto --merge "$PR_URL"
        env:
          PR_URL: ${{github.event.pull_request.html_url}}
          GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}



================================================
FILE: .github/workflows/fix-php-code-style-issues.yml
================================================
name: Fix PHP code style issues

on:
  push:
    paths:
      - '**.php'

jobs:
  php-code-styling:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          ref: ${{ github.head_ref }}

      - name: Fix PHP code style issues
        uses: aglipanci/laravel-pint-action@2.4

      - name: Commit changes
        uses: stefanzweifel/git-auto-commit-action@v4
        with:
          commit_message: Fix styling



================================================
FILE: .github/workflows/run-tests.yml
================================================
name: Tests

on: [push, pull_request]

jobs:
  test:
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: true
      matrix:
        os: [ubuntu-latest, windows-latest]
        php: [8.2, 8.1, 8.0, 7.4]
        stability: [prefer-lowest, prefer-stable]

    name: P${{ matrix.php }} - ${{ matrix.stability }} - ${{ matrix.os }}

    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Setup PHP
        uses: shivammathur/setup-php@v2
        with:
          php-version: ${{ matrix.php }}
          extensions: dom, json, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, bcmath, soap, intl, gd, exif, iconv, imagick, fileinfo
          coverage: none

      - name: Setup problem matchers
        run: |
          echo "::add-matcher::${{ runner.tool_cache }}/php.json"
          echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json"

      - name: Install dependencies
        run: composer update --${{ matrix.stability }} --prefer-dist --no-interaction

      - name: Execute tests
        run: vendor/bin/pest



================================================
FILE: .github/workflows/update-changelog.yml
================================================
name: "Update Changelog"

on:
  release:
    types: [released]

jobs:
  update:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          ref: main

      - name: Update Changelog
        uses: stefanzweifel/changelog-updater-action@v1
        with:
          latest-version: ${{ github.event.release.name }}
          release-notes: ${{ github.event.release.body }}

      - name: Commit updated CHANGELOG
        uses: stefanzweifel/git-auto-commit-action@v4
        with:
          branch: main
          commit_message: Update CHANGELOG
          file_pattern: CHANGELOG.md