jolicode / jolinotif
在 Windows、Linux、MacOS 上发送桌面通知。
v2.7.2
2024-06-01 06:05 UTC
Requires
- php: >=8.1
- jolicode/php-os-helper: ^0.1.0
- psr/log: ^1.0 || ^2.0 || ^3.0
- symfony/deprecation-contracts: ^3
- symfony/process: ^5.4 || ^6.0 || ^7.0
Requires (Dev)
- symfony/finder: ^5.4 || ^6.0 || ^7.0
- symfony/phpunit-bridge: ^5.4 || ^6.0 || ^7.0
Suggests
- ext-ffi: Needed to send notifications via libnotify on Linux
README
关于 JoliNotif
JoliNotif 是一个跨平台的 PHP 库,用于显示桌面通知。它可以在 Linux、Windows 或 macOS 上运行。
要求 PHP >= 8.1(1.x 版本支持 PHP 5,< 2.1.0 版本支持 PHP 7.0 和 7.1,< 2.4.0 版本支持 PHP 7.2 和 7.3,2.6.0 版本支持 PHP < 8.0)。
注意
此库不能在 Web 上下文中使用(FPM 或等效)。请在您的 CLI 脚本或 CRON 中使用。
安装
使用 Composer 在您的项目中安装 JoliNotif
composer require "jolicode/jolinotif"
用法
include __DIR__.'/vendor/autoload.php'; use Joli\JoliNotif\Notification; use Joli\JoliNotif\DefaultNotifier; $notifier = new DefaultNotifier(); // Create your notification $notification = (new Notification()) ->setTitle('Notification title') ->setBody('This is the body of your notification') ->setIcon(__DIR__.'/path/to/your/icon.png') ->addOption('subtitle', 'This is a subtitle') // Only works on macOS (AppleScriptDriver) ->addOption('sound', 'Frog') // Only works on macOS (AppleScriptDriver) ; // Send it $notifier->send($notification);
还提供了一个 shell 可执行文件,可以从 CLI 使用 JoliNotif
jolinotif --title "Hello" --body "World"
更多文档
通过阅读文档来了解更多信息
您可以使用以下方法查看当前和过去版本:
git tag
命令- GitHub 上的发行页面
- 列出版本之间更改的文件
最后是一些元文档
鸣谢
- 所有贡献者
- 该项目最初受到 mikaelbr/node-notifier 的启发
许可证
JoliNotif 根据 MIT 许可证授权 - 有关详细信息,请参阅 LICENSE 文件。