README

rencon是一个轻量级的浏览器基于简易服务器管理工具。

由1个PHP脚本文件构成，使用时随时可用，使用完毕后可轻松删除。基于GUI的Web应用程序，因此即使不习惯于日常命令操作的人也可以操作。

提供以下功能。

• 文件和文件夹
• 数据库操作

安装步骤 - Install

将位于dist目录中的rencon.php放置在您使用的Web服务器的文档根以下任意位置，然后通过Web浏览器访问。

示例：手动安装

• 从版本列表页面下载最新版本的rencon.php。
• 使用文本编辑器打开，根据需要更改设置。（可选）
• 使用FTP工具等将文件上传到您Web服务器的文档根以下任意位置。
• 通过Web浏览器访问。

示例：使用curl命令

$ cd /path/to/your/htdocs/(foo)/(bar);
$ curl https://github.com/tomk79/rencon/releases/download/0.0.1/rencon.php -L -o rencon.php;

使用文本编辑器打开，根据需要更改设置。（可选）

$ vi rencon.php

设置 - Configuration

打开rencon.php时，在开头附近有以

// =-=-=-=-=-=-=-=-=-=-=-= Configuration START =-=-=-=-=-=-=-=-=-=-=-=
$conf = new stdClass();

开始的设置区域。

通过更改$conf的值，可以控制rencon的功能。

登录用户设置

rencon的初始界面从登录界面开始。只有$conf->users中注册的用户才能登录。请使用用户ID作为键，将sha1哈希后的密码字符串作为值设置成关联数组。可以注册多个用户。

$conf->users = array(
	"admin" => sha1("admin"),
);

如果不注册用户，则可以不登录使用。如果想要这样，请将$conf->users设置为null。

$conf->users = null;

禁用功能

$conf->disabled = array(
	'databases', // データベース操作を無効化
	'files', // ファイルとフォルダ操作を無効化
	'phpinfo', // phpinfo() の閲覧を無効化
);

数据库连接信息设置

设置连接数据库所需的信息。可以使用关联数组设置多个连接点。

$conf->databases = array(
  "main_db" => array(
    "dsn" => "sqlite:./db/database.sqlite", // PDOの第1引数に渡される値
    "driver" => "sqlite", // DBドライバ名 (`dsn` が設定される場合は不要)
    "host" => "127.0.0.1", // 接続先ホスト名 (`dsn` が設定される場合は不要)
    "port" => 3306, // 接続先ポート番号 (`dsn` が設定される場合は不要)
    "database" => "my_database_name", // 接続先データベース名 (`dsn` が設定される場合は不要)
    "username" => "user", // ログインユーザー名
    "password" => "passwd", // ログインパスワード
    "options" => array(), // PDOオプション
  ),
);

文件列表的根目录

$conf->files_path_root = '/';

不显示的路径列表

$conf->files_paths_invisible = array();

不可编辑的路径列表

$conf->files_paths_readonly = array(
	'/*',
);

系统要求 - System Requirement

• PHP 5.4+ 运行的Web服务器
• mbstring必须启用。
• 使用数据库操作时
  • PDO必须启用。
  • 必须启用与使用的DBMS对应的PDO驱动程序。

(!) 注意事项

此工具会将服务器上本不应从浏览器中可见的信息显示出来，如果被第三方滥用则非常危险。

• 请在已确认安全的环镜中使用。
• 请勿将其安装在可以访问个人资料或重要机密信息的服务器上。
• 请使用后立即删除。

更新日志 - Change log

rencon v0.0.1 (2020年2月7日)

• 初始发布。

开发者信息 - for Developer

构建 - Build

$ php build/build.php

测试 - Test

$ php vendor/phpunit/phpunit/phpunit

许可 - License

MIT许可

作者 - Author

• Tomoya Koyanagi tomk79@gmail.com
• 网站：https://www.pxt.jp/
• Twitter: @tomk79 https://twitter.com/tomk79/