tburry/pxgif

一个用于生成1×1像素GIF的小类。

v1.0.0 2014-01-23 22:24 UTC

This package is auto-updated.

Last update: 2024-09-15 13:35:07 UTC


README

Pxgif是一个用于生成1像素GIF的小类。

为什么我需要生成1像素GIF?

除非你极度OCD,否则你很可能不需要生成1像素GIF,除非你在REST API中返回正确的MIME类型。这个类正是为此而设计的。以下是一些用例:

  • 你正在制作一个类似Google Analytics的跟踪器,它会在页面上添加一个图像来跟踪页面访问。你可以使用echo Pxgif::gifStr(0, 0, 0, true)来生成一个1像素的透明GIF。

  • 假设你正在编写一个PHP脚本以某种方式操作图像(例如,Facebook将大多数图像通过safe_image.php脚本传递)。如果该脚本失败,你应该仍然写入有效的图像,因为浏览器期望得到一个。你可以使用echo Pxgif::httpStr($code)来输出一个1像素的GIF以指示HTTP错误代码。

安装

要使用Pxgif,你只需要包含一个文件:Pxgif.php。然后你只需要调用Pxgif类上的任何静态方法。

基本示例

以下示例将输出一个1像素透明GIF。

// Require the class.
require 'Pixgif.php';

// Do something interesting, like track a page view.
// ...

// Set the appropriate response headers.
header("Content-type:  image/gif");
header("Expires: Wed, 11 Nov 1998 11:11:11 GMT");
header("Cache-Control: no-cache");
header("Cache-Control: must-revalidate");

// Dump the gif.
Pxgif::gifStr();

花哨的HTTP状态颜色(哇!)

当你调用Pxgif::httpStr()时,你会得到一个表示HTTP状态码的1像素GIF的字符串。该GIF的颜色编码表示错误的成功或严重性。

GIF根据其错误类型进行颜色编码。

1xx 信息性:黑色

2xx 成功:绿色

3xx 重定向:蓝色(虽然你不太可能看到这个)

4xx 客户端错误:橙色

5xx 服务器错误:红色

状态码彩蛋

如果你真的很细心,你将能够仅通过查看生成的GIF的颜色来识别响应代码(提示:阅读十六进制代码)(提示:提示:查看源代码)。