monica 是一个个人的 CRM(客户关系管理)系统,可以自己架设服务,管理你的所有人际关系。
环境参数
以下是我本次安装时的软硬件配置信息:
- Macbook Pro v10.15.7 (macOS Catalina)
- MAMP Pro v5.7 (Apache)
- PHP v7.4.2
- Composer v2.0.8
- MySQL v5.7.26
准备工作
官方文档中已经列出安装 monica 所必备的环境配置:
- Git
- PHP 7.2+
- HTTP server with PHP support (eg: Apache, Nginx, Caddy)
- Composer
- MySQL
- Optional: Redis or Beanstalk
同时官方也提供了详尽的 install 文档,作为开发攻城狮,Git 是你的必备工具,同时 MacOS 默认安装 Git,如果你安装了 Xcode;
MAMP 提供了一套完整的本地 web 开发环境,MAMP Pro 破解版百度能出来一堆,所以不再赘述;
以上解决了 Git、PHP、HTTP server、MySQL、Redis 等必备软件配置;剩下的就是安装 Composer,Composer 是 PHP 的一个依赖管理工具,因为 MacOS 自带 PHP 环境,但是有可能版本比较低,不符合 monica 的安装要求;
我们本地的 web 环境是用 MAMP 搭建的,所以当然要使用 MAMP 自带的 PHP 了,那么问题就成了怎么使用 MAMP 的 PHP 来安装 Composer?看这里,有教程哦~
好了,至此,安装 monica 的必备环境配置已完成,接下来我们进入正题;
安装 Monica
安装步骤我是按照官方文档来进行的:
- 克隆/下载 monica 源代码程序至本地 varcrm 目录
cd /Volumes/Dev/Site
git clone https://github.com/monicahq/monica.git varcrm
- 设置数据库
打开 MAMP Pro 自带的 MySQL 数据库:
点击账户 -> 新增用户账户
输入数据库相关信息:
- 用户名: monica
- 主机名: 本地(localhost)
- 密码: strongpassword
- 勾选
创建与用户同名的数据库并授予所有权限
- 全局全选:勾选
全选
如图,然后点击右下角【执行】,数据库和数据库用户就创建好了;
- 配置 Monica
cd /Volumes/Dev/Site/monica
切换至 monica 项目根目录;cp .env.example .env
创建项目环境变量配置文件;- 修改
.env
配置文件:设置DB_USERNAME
和DB_PASSWORD
的值,即创建数据库时设置的值; - 执行
composer install --no-interaction --no-suggest --no-dev --ignore-platform-reqs
命令安装所有软件包; - 执行
php artisan key:generate
命令生成应用密钥,并自动修改APP_KEY
的值; - 执行
php artisan setup:production -v
命令设置数据库和 symlink 文件夹;
至此,monica 已经安装完成,还有一些辅助功能可以参照官方文档进行安装;
- 配置本地预览域名
在 MAMP 中配置 monica 的预览地址:
之后在浏览器打开设置的域名地址,应该就能看到登录页面了;
- 默认登录账号:
在第 3 步执行 php artisan setup:production -v
命令时,monica 程序在数据库中插入了两个用户,admin@admin.com 和 blank@blank.com,密码分别为 admin0 和 blank0;这个在代码中也能找到:
至此,Monica 程序安装完成;
常见问题
- 点击登录后,提示
You need to install the imagick extension to use this back end
;
这个是因为没有安装 imagick
扩展包,不用担心,这个扩展包 MAMP 默认自带,只需要设置开启就可以了:
- 执行
php artisan setup:production -v
命令后报错,命令行提示数据库拒接链接;
如果你先配置好了域名,这是浏览器打开页面,会看到提示:
select * from `cache` where `key` = laravel_cachecloudflare.proxies limit 1
这是因为 MAMP 本地数据库拒绝链接,需要设置一下就可以了:
相关链接: