安装与配置

环境依赖

• PHP：必须，世界上最好的语言。
• MySQL：必须，我的发音是 My S-Q-L，不是 My sequel，更不是 My 色扣。
• Redis：可选，仅在需要使用 Redis 作为缓存、会话或队列驱动时使用。
• Nginx：可选，生产部署常用，本地可直接使用 php artisan serve。
• Composer：部署使用，安装 PHP 依赖。
• Npm：部署使用，构建前端资源。

The official way to pronounce “MySQL” is “My Ess Que Ell” (not “my sequel”), but we do not mind if you pronounce it as “my sequel” or in some other localized way.

部署步骤

进入项目的根目录：

cd bookstack-basic

安装 PHP 依赖：

composer install

安装前端依赖：

npm install

构建静态资源：

npm run build

复制环境配置：

cp .env.example .env

修改 .env，确认以下配置：

APP_URL=http://localhost:8402

DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=bookstack
DB_USERNAME=root
DB_PASSWORD=

如果你要使用 Redis，可额外设置：

CACHE_DRIVER=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis
REDIS_SERVERS=127.0.0.1:6379:0

生成应用密钥：

php artisan key:generate

执行数据库迁移：

php artisan migrate

导入示例数据（可选）：

php artisan bookstack:import-demo-content

运行项目，直接启动内置服务：

php artisan serve --host=127.0.0.1 --port=8402

访问：

http://127.0.0.1:8402

账号密码

admin@admin.com

password