php-heic-to-jpg 项目下载及安装教程
项目地址: https://gitcode.com/gh_mirrors/ph/php-heic-to-jpg 1. 项目介绍
php-heic-to-jpg 是一个用于将 HEIC/HEIF 图像转换为 JPEG 格式的 PHP 项目，特别适用于 Laravel 框架。该项目使用 Go 语言编写的二进制文件，无需依赖其他 PHP 库或第三方软件。它提供了简单易用的接口，支持多种操作系统和架构，能够高效地完成图像格式转换。
2. 项目下载位置
项目托管在 GitHub 上，可以通过以下命令克隆项目到本地：
git clone https://github.com/MaestroError/php-heic-to-jpg.git
3. 项目安装环境配置
3.1 系统要求
- PHP 7.0 或更高版本
- Composer
- Go 语言环境（用于编译二进制文件）
3.2 环境配置示例
3.2.1 PHP 安装
确保你的系统中已经安装了 PHP。可以通过以下命令检查 PHP 版本：
php -v
3.2.2 Composer 安装
Composer 是 PHP 的依赖管理工具，可以通过以下命令安装：
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
3.2.3 Go 语言环境安装
Go 语言环境可以通过以下命令安装：
sudo apt-get install golang
4. 项目安装方式
4.1 使用 Composer 安装
进入项目根目录，运行以下命令安装依赖：
composer install
4.2 编译 Go 二进制文件
在项目根目录下，运行以下命令编译 Go 二进制文件：
go build -o heic-to-jpg main.go
5. 项目处理脚本
5.1 基本使用
使用 HeicToJpeg 类进行图像转换非常简单。以下是一个示例：
// 保存为文件
Maestroerror\HeicToJpg::convert("image1.heic")->saveAs("image1.jpg");
// 获取转换后的 JPG 内容
$jpg = Maestroerror\HeicToJpg::convert("image1.heic")->get();
5.2 针对 MacOS 用户的特殊处理
如果你使用的是 MacOS 系统，可以使用 convertOnMac 方法指定架构：
Maestroerror\HeicToJpg::convertOnMac("image1.heic", "arm64")->saveAs("image1.jpg");
5.3 处理 'mdat' 文件转换问题
如果遇到某些三星设备生成的图像无法转换的问题，可以按照以下步骤处理：
-
确保安装了
maestroerror/heif-converter包：composer require maestroerror/heif-converter -
确保系统中安装了
libheif。 -
在转换方法中指定
heif-converter的路径：HeicToJpg::convert("image.heic", "path/to/your/bin/heif-converter-[linux/windows/macos]")->saveAs("image.jpg");
通过以上步骤，你应该能够顺利完成 php-heic-to-jpg 项目的下载、安装及使用。