PsySH 使用教程

PsySH 使用教程

psyshA REPL for PHP项目地址:https://gitcode.com/gh_mirrors/ps/psysh

1. 项目的目录结构及介绍

PsySH 是一个用于 PHP 的运行时开发控制台、交互式调试器和 REPL（Read-Eval-Print Loop）。以下是 PsySH 项目的基本目录结构及其介绍：

psysh/
├── bin/
│   └── psysh
├── src/
│   ├── Psy/
│   │   ├── Command/
│   │   ├── Exception/
│   │   ├── Output/
│   │   ├── Parser/
│   │   ├── Reflection/
│   │   ├── Shell/
│   │   ├── VersionUpdater/
│   │   └── Sh.php
│   └── psysh.php
├── tests/
│   ├── Psy/
│   │   ├── Command/
│   │   ├── Exception/
│   │   ├── Output/
│   │   ├── Parser/
│   │   ├── Reflection/
│   │   ├── Shell/
│   │   ├── VersionUpdater/
│   │   └── ShTest.php
│   └── bootstrap.php
├── composer.json
├── LICENSE
└── README.md

• bin/：包含可执行文件 psysh，用于启动 PsySH。
• src/：包含 PsySH 的核心源代码。
  • Psy/：包含各种功能模块，如命令、异常处理、输出、解析器、反射、Shell 等。
  • psysh.php：PsySH 的主入口文件。
• tests/：包含单元测试和功能测试。
• composer.json：Composer 依赖管理文件。
• LICENSE：项目许可证文件。
• README.md：项目说明文档。

2. 项目的启动文件介绍

PsySH 的启动文件位于 bin/psysh。这是一个可执行的 PHP 脚本，用于启动 PsySH 的交互式 Shell。以下是启动文件的基本内容：

#!/usr/bin/env php
<?php

Phar::mapPhar('psysh.phar');
require 'phar://psysh.phar/bin/psysh';

__HALT_COMPILER();

• #!/usr/bin/env php：指定使用 PHP 解释器来执行该脚本。
• Phar::mapPhar('psysh.phar')：如果 PsySH 被打包成 Phar 文件，则映射 Phar 文件。
• require 'phar://psysh.phar/bin/psysh'：加载并执行 PsySH 的主入口文件。

3. 项目的配置文件介绍

PsySH 的配置文件通常是一个 PHP 文件，用于自定义 PsySH 的行为。默认情况下，PsySH 会在用户的主目录下查找 .psysh.php 文件作为配置文件。以下是一个示例配置文件的内容：

<?php

return [
    'defaultIncludes' => [
        __DIR__ . '/includes.php',
    ],
    'historyFile' => __DIR__ . '/.psysh_history',
    'errorLoggingLevel' => E_ALL & ~E_NOTICE,
    'configDir' => __DIR__ . '/.psysh',
    'runtimeDir' => sys_get_temp_dir() . '/psysh',
];

• defaultIncludes：指定启动时默认加载的文件。
• historyFile：指定历史记录文件的路径。
• errorLoggingLevel：指定错误日志的级别。
• configDir：指定配置文件的目录。
• runtimeDir：指定运行时目录。

通过这些配置选项，用户可以自定义 PsySH 的行为，以满足不同的开发需求。

psyshA REPL for PHP项目地址:https://gitcode.com/gh_mirrors/ps/psysh