Skip to content

Commit 438b833

Browse files
committed
update README.md
1 parent d533db7 commit 438b833

File tree

1 file changed

+62
-42
lines changed

1 file changed

+62
-42
lines changed

README.md

Lines changed: 62 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -1,43 +1,39 @@
1-
# Laravel 小程序图文海报生成
1+
# Laravel 小程序图文海报生成包
22

3-
* 项目基于[**PhantomMagick**](https://github.com/anam-hossain/phantommagick)
3+
微信小程序中生成朋友圈分享图文海报的一种解决方案
44

5+
[![Build Status](https://travis-ci.org/ibrandcc/laravel-miniprogram-poster.svg?branch=master)](https://travis-ci.org/ibrandcc/laravel-miniprogram-poster)
6+
[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/ibrandcc/laravel-miniprogram-poster/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/ibrandcc/laravel-miniprogram-poster/?branch=master)
7+
[![Code Coverage](https://scrutinizer-ci.com/g/ibrandcc/laravel-miniprogram-poster/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/ibrandcc/laravel-miniprogram-poster/?branch=master)
8+
[![Build Status](https://scrutinizer-ci.com/g/ibrandcc/laravel-miniprogram-poster/badges/build.png?b=master)](https://scrutinizer-ci.com/g/ibrandcc/laravel-miniprogram-poster/build-status/master)
59

6-
### 安装
7-
```
8-
composer require ibrand/laravel-miniprogram-poster
10+
## Featrue
911

10-
```
12+
1. 基于html可实现复杂的文字,图片,阴影效果。
13+
2. 清晰度和文件大小合理
14+
3. 使用简单、即插即用
1115

12-
* 依赖phantomjs。
16+
## TODO:
1317

14-
* 非linux环境下安装:[phantomjs](http://phantomjs.org/download.html)
18+
1. 存储 Model 对象和图片对应关系,避免重复生成图片。
1519

16-
* mac环境下推荐使用 brew 安装phantomjs
17-
```
18-
brew install phantomjs
19-
```
20-
* 如果laravel版本小于5.5,需要在config/app.php providers数组添加如下代码
21-
```
22-
iBrand\Poster\PhantoMmagickServiceProvider::class
23-
```
24-
```
25-
php artisan storage:link
26-
php artisan vendor:publish --provider="iBrand\Poster\PhantoMmagickServiceProvider" --tag="config"
27-
```
28-
### 字体安装
29-
* window 将下载的字体文件复制到C:Windows\Fonts目录下或者双击字体文件进行安装
30-
* linux
20+
> 该功能待整理出来已经使用在生产环境
21+
22+
## 体验
23+
24+
扫码进入商品详情页分享生成图文体验
25+
26+
![iBrand开源体验店](https://iyoyo.oss-cn-hangzhou.aliyuncs.com/post/miniprogramcode/1.jpg)
27+
28+
### 安装
3129
```
32-
cd /usr/share/fonts
33-
mkdir newfont
34-
#将下载的字体文件复制进这个目录
35-
cd newfont
36-
mkfontscale
37-
mkfontdir
38-
fc-cache
30+
composer require ibrand/laravel-miniprogram-poster
3931
```
40-
* mac 下载的字体文件 双击字体文件进行安装
32+
- 低于 Laravel5.5 版本,`config/app.php` 文件中 'providers' 添加`iBrand\Poster\PhantoMmagickServiceProvider::class`
33+
34+
- 图片保存在 `storage/app/public` 下所以需要执行 `php artisan storage:link`
35+
36+
- 如需自定义配置请执行 `php artisan vendor:publish --provider="iBrand\Poster\PhantoMmagickServiceProvider" --tag="config"`
4137

4238
### 配置项
4339

@@ -63,20 +59,44 @@ composer require ibrand/laravel-miniprogram-poster
6359
];
6460
```
6561

66-
### 示例
62+
### 使用
6763
```
68-
use iBrand\Miniprogram\Poster\MiniProgramShareImg;
64+
use iBrand\Miniprogram\Poster\MiniProgramShareImg;
6965
70-
$url = 'https://www.ibrand.cc/';
71-
$result = MiniProgramShareImg::generateShareImage($url);
72-
73-
/*返回值:$result
66+
$url = 'https://www.ibrand.cc/';
67+
$result = MiniProgramShareImg::generateShareImage($url);
68+
69+
```
70+
返回结果:
71+
```
7472
[
75-
'url' => 'http://xxx.png',图片访问路径
76-
'path' => 'path/to/image', 图片相对路径
73+
'url' => 'http://xxx.png', 图片访问url
74+
'path' => 'path/to/image', 图片文件路径
7775
]
78-
/*
7976
```
77+
### 字体安装
78+
79+
如果需要实现复杂的字体效果,需要安装字体,比如在 centos 上就没有微软雅黑的字体,所以如果生成的图片有指定的特殊字体,需要在服务器上进行安装。
80+
81+
* window 将下载的字体文件复制到C:Windows\Fonts目录下或者双击字体文件进行安装
82+
* mac 下载的字体文件 双击字体文件进行安装
83+
* centos
84+
```
85+
# 安装微软雅黑
86+
wget -P /tmp/ https://iyoyo.oss-cn-hangzhou.aliyuncs.com/mirror/fonts/msyh.ttf
87+
wget -P /tmp/ https://iyoyo.oss-cn-hangzhou.aliyuncs.com/mirror/fonts/msyhbd.ttf
88+
wget -P /tmp/ https://iyoyo.oss-cn-hangzhou.aliyuncs.com/mirror/fonts/msyhl.ttf
89+
cd /usr/share/fonts/lyx/
90+
mkdir chinese
91+
cd chinese
92+
mv /tmp/msyhbd.ttf ./
93+
chmod 755 *.ttf
94+
yum -y install mkfontscale
95+
mkfontscale
96+
mkfontdir
97+
fc-cache -fv
98+
```
99+
100+
### Resource
80101

81-
* 生成图片效果如下:<br/>
82-
![效果图](http://admin.dev.tnf.ibrand.cc/storage/upload/image/72b60d1d2daa9395b7d502e74a08c138.png)
102+
项目基于[PhantomMagick](https://github.com/anam-hossain/phantommagick)

0 commit comments

Comments
 (0)