MacOS 本地环境搭建 monica

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

安装步骤我是按照官方文档来进行的:

  1. 克隆/下载 monica 源代码程序至本地 varcrm 目录
cd /Volumes/Dev/Site
git clone https://github.com/monicahq/monica.git varcrm
  1. 设置数据库

打开 MAMP Pro 自带的 MySQL 数据库:

1607405061139.jpg

点击账户 -> 新增用户账户

1607405282899.jpg

输入数据库相关信息:

  • 用户名: monica
  • 主机名: 本地(localhost)
  • 密码: strongpassword
  • 勾选 创建与用户同名的数据库并授予所有权限
  • 全局全选:勾选 全选

如图,然后点击右下角【执行】,数据库和数据库用户就创建好了;

1607405480810.jpg

  1. 配置 Monica
  • cd /Volumes/Dev/Site/monica 切换至 monica 项目根目录;
  • cp .env.example .env 创建项目环境变量配置文件;
  • 修改 .env 配置文件:设置 DB_USERNAMEDB_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 已经安装完成,还有一些辅助功能可以参照官方文档进行安装;

  1. 配置本地预览域名

在 MAMP 中配置 monica 的预览地址:

1607409526443.jpg

之后在浏览器打开设置的域名地址,应该就能看到登录页面了;

  1. 默认登录账号:

在第 3 步执行 php artisan setup:production -v 命令时,monica 程序在数据库中插入了两个用户,admin@admin.com 和 blank@blank.com,密码分别为 admin0 和 blank0;这个在代码中也能找到:

1607409984323.jpg

至此,Monica 程序安装完成;

常见问题

  1. 点击登录后,提示 You need to install the imagick extension to use this back end

这个是因为没有安装 imagick 扩展包,不用担心,这个扩展包 MAMP 默认自带,只需要设置开启就可以了:

1607410346687.jpg

  1. 执行 php artisan setup:production -v 命令后报错,命令行提示数据库拒接链接;

如果你先配置好了域名,这是浏览器打开页面,会看到提示:

select * from `cache` where `key` = laravel_cachecloudflare.proxies limit 1

这是因为 MAMP 本地数据库拒绝链接,需要设置一下就可以了:

1607410733051.jpg

相关链接:

发表评论
* 昵称
* Email
* 网址
* 评论