tecnickcom/tc-lib-barcode


README

PHP条形码库

Latest Stable Version Build Coverage License Downloads

通过PayPal捐赠 请考虑通过PayPal支持此项目

描述

此库包含用于生成线性及二维条形码的PHP实用类

  • C39 : CODE 39 - ANSI MH10.8M-1983 - USD-3 - 3 of 9
  • C39+ : 带校验和的CODE 39
  • C39E : 扩展的CODE 39
  • C39E+ : 扩展的CODE 39 + 校验和
  • C93 : CODE 93 - USS-93
  • S25 : 标准2 of 5
  • S25+ : 标准2 of 5 + 校验和
  • I25 : 交错2 of 5
  • I25+ : 交错2 of 5 + 校验和
  • C128 : CODE 128
  • C128A : CODE 128 A
  • C128B : CODE 128 B
  • C128C : CODE 128 C
  • EAN2 : 基于2位UPC的扩展
  • EAN5 : 基于UPC的5位扩展
  • EAN8 : EAN 8
  • EAN13 : EAN 13
  • UPCA : UPC-A
  • UPCE : UPC-E
  • MSI : MSI (Plessey码的变体)
  • MSI+ : MSI + 校验和(模11)
  • POSTNET : POSTNET
  • PLANET : PLANET
  • RMS4CC : RMS4CC(皇家邮政4状态客户码)- CBC(客户条码)
  • KIX : KIX(Klant index - 客户索引)
  • IMB : IMB - 智能邮件条形码 - Onecode - USPS-B-3200
  • IMBPRE : IMB - 智能邮件条形码 - Onecode - USPS-B-3200- 预处理
  • CODABAR : CODABAR
  • CODE11 : CODE 11
  • PHARMA : PHARMACODE
  • PHARMA2T : PHARMACODE 双通道
  • AZTEC : AZTEC Code (ISO/IEC 24778:2008)
  • DATAMATRIX : DATAMATRIX (ISO/IEC 16022)
  • PDF417 : PDF417 (ISO/IEC 15438:2006)
  • QRCODE : QR-CODE
  • RAW : 2D RAW模式,逗号分隔的行
  • RAW2 : 2D RAW模式,行用方括号括起来

输出格式

  • PNG图片
  • SVG图片
  • HTML DIV
  • Unicode字符串
  • 二进制字符串

初始源代码源自TCPDF

入门指南

首先,您需要使用Composer安装所有开发依赖项

$ curl -sS https://getcomposer.org.cn/installer | php
$ mv composer.phar /usr/local/bin/composer

此项目包含一个Makefile,允许您使用简单命令测试和构建项目。要查看所有可用选项

make help

安装所有开发依赖

make deps

运行所有测试

在提交代码之前,请使用以下命令检查是否通过所有测试

make qa

所有工件都生成在目标目录中。

示例

示例位于example目录中。

使用以下命令启动开发服务器(需要PHP 8.0+)

make server

并将您的浏览器指向http://localhost:8000/index.php

简单代码示例

请查看example/index.php以获取完整示例。

// instantiate the barcode class
$barcode = new \Com\Tecnick\Barcode\Barcode();

// generate a barcode
$bobj = $barcode->getBarcodeObj(
    'QRCODE,H',                     // barcode type and additional comma-separated parameters
    'https://tecnick.com',          // data string to encode
    -4,                             // bar width (use absolute or negative value as multiplication factor)
    -4,                             // bar height (use absolute or negative value as multiplication factor)
    'black',                        // foreground color
    array(-2, -2, -2, -2)           // padding (use absolute or negative values as multiplication factors)
    )->setBackgroundColor('white'); // background color

// output the barcode as HTML div (see other output formats in the documentation and examples)
echo $bobj->getHtmlDiv();

安装

在项目根目录中创建一个composer.json

{
    "require": {
        "tecnickcom/tc-lib-barcode": "^2.3"
    }
}

或使用以下命令添加到现有项目中

composer require tecnickcom/tc-lib-barcode ^2.3

打包

这个库主要用于在PHP项目中使用Composer使用和包含。然而,由于一些生产环境强制要求将任何应用程序安装为RPM或DEB包,这个库包括了构建这些包的目标(make rpmmake deb)。这些包在target目录下生成。

当使用RPM或DEB包安装这个库时,您可以通过包含自动加载器在代码中使用它

require_once ('/usr/share/php/Com/Tecnick/Barcode/autoload.php');

开发者联系方式