PHP

发布日期: 2022-04-05

文章字数: 2.1k

阅读时长: 10 分钟

阅读次数:

一、Composer简介

Composer 是 PHP 的一个依赖管理工具。它允许你申明项目所依赖的代码库，它会在你的项目中为你安装他们。

二、准备工作

一个github账号
一个packagist账号
一台安装composer的开发机

packagist	github	composer
packagist注册链接	github注册链接	composer文档

三、发布流程

1.首先在github上创建一个项目

2.把项目克隆到本地

git clone git@github.com:chendujin/validator.git

3.进入项目根目录初始化项目

➜  validator git:(master) composer init
                                            
  Welcome to the Composer config generator  
                                            
This command will guide you through creating your composer.json config.
Package name (<vendor>/<name>) [chendujin/validator]: 
Description []: a xdp framework
Author [北行10000 <13341007105@163.com>, n to skip]: 
Minimum Stability []: dev
Package Type (e.g. library, project, metapackage, composer-plugin) []: 
License []: MIT
Define your dependencies.
Would you like to define your dependencies (require) interactively [yes]? 
Search for a package: 
Would you like to define your dev dependencies (require-dev) interactively [yes]? 
Search for a package: 
{
	"name": "chendujin/validator",
	"description": "各种验证类包",
	"type": "library",
	"license": "MIT",
	"authors": [
		{
            "name": "chendujin",
            "email": "1096381436@qq.com"
        }
	],
	"minimum-stability": "alpha",
	"require": {
		"php": ">=7.1.0"
	},
	"autoload": {
        "psr-4": {
            "DataTrans\\": "src/"
        }
    }
}
Do you confirm generation [yes]? 
Would you like the vendor directory added to your .gitignore [yes]? yes

此时目录下回程车一个composer.json文件，文件内容形如：

{
  "name": "chendujin/validator",
  "description": "各种验证类包",
  "type": "library",
  "license": "MIT",
  "authors": [
    {
      "name": "chendujin",
      "email": "1096381436@qq.com"
    }
  ],
  "minimum-stability": "alpha",
  "require": {
    "php": ">=7.1.0"
  },
  "autoload": {
    "psr-4": {
      "DataTrans\\": "src/"
    }
  }
}

4.编写自己的composer包

4.1 此处我创建了一个src目录并实现了Validator类

➜  validator git:(master) ✗ tree
.
├── README.md
├── composer.json
└── src
    └── Validator.php

4.2 Validator类

<?php

/**
 * 全局数据验证类。
 * @author fingerQin
 */

namespace DataTrans;

class Validator {

    /**
     * 判断是否为合法的用户名。
     * @param string $username
     * @param int $min_len 最小长度。包含。
     * @param int $max_len 最大长度。包含。
     * @param string $mode 用户名模式：digit、alpha、digit_alpha、chinese、digit_alpha_chinese、mix
     *            digit：数字
     *            aplha：字母
     *            digit_alpha：数字和字母
     *            chinese：中文
     *            digit_alpha_chinese：数字字母中文
     *            mix：混合型：数字字母中文下划线破折号
     * @return bool
     */
    public static function is_username($username, $min_len, $max_len, $mode = 'mix') {
        switch ($mode) {
            case 'digit':
                return preg_match("/^\d{{$min_len},{$max_len}}$/", $username) ? true : false;
                break;

            case 'alpha':
                return preg_match("/^([a-zA-Z]){{$min_len},{$max_len}}$/", $username) ? true : false;
                break;

            case 'digit_alpha':
                return preg_match("/^([a-z0-9_-]){{$min_len},{$max_len}}$/", $username) ? true : false;
                break;

            case 'chinese':
                return (preg_match("/^[\x7f-\xff]{{$min_len},{$max_len}}$/", $username)) ? true : false;
                break;

            case 'digit_alpha_chinese':
                return (preg_match("/^[\x7f-\xff|0-9a-zA-Z]{{$min_len},{$max_len}}$/", $username)) ? true : false;
                break;

            case 'mix':
            default:
                return (preg_match("/^[\x7f-\xff|0-9a-zA-Z-_]{{$min_len},{$max_len}}$/", $username)) ? true : false;
                break;
        }
    }

    /**
     * 判断是否为合法的密码。
     * @param string $password
     * @param int $min_len 最小长度。包含。
     * @param int $max_len 最大长度。包含。
     * @param string $mode 用户名模式：digit_alpha、mix
     *            digit_alpha：数字和字母
     *            mix：混合型：数字字母下划线破折号
     * @return bool
     */
    public static function is_password($password, $min_len, $max_len, $mode = 'mix') {
        switch ($mode) {
            case 'digit_alpha':
                return preg_match("/^([a-z0-9]){{$min_len},{$max_len}}$/", $password) ? true : false;
                break;

            case 'mix':
            default:
                return (preg_match("/^[0-9a-zA-Z-_]{{$min_len},{$max_len}}$/", $password)) ? true : false;
                break;
        }
    }

    /**
     * 判断是否为QQ号码。
     * @param string $qq
     * @return boolean
     */
    public static function is_qq($qq) {
        return preg_match('/^[1-9]\d{4,12}$/', $qq) ? true : false;
    }

    /**
     * 判断是否为手机号码。
     * @param string $mobilephone
     * @return boolean
     */
    public static function is_mobilephone($mobilephone) {
        return preg_match('/^13[\d]{9}$|14^[0-9]\d{8}|^15[0-9]\d{8}$|^18[0-9]\d{8}$/', $mobilephone) ? true : false;
    }

    /**
     * 判断是否为座机号码。
     * @param string $telphone
     * @return boolean
     */
    public static function is_telphone($telphone) {
        return preg_match('/^((\(\d{2,3}\))|(\d{3}\-))?(\(0\d{2,3}\)|0\d{2,3}-)?[1-9]\d{6,7}(\-\d{1,4})?$/', $telphone) ? true : false;
    }

    /**
     * 判断是否为邮政编码。
     * @param string $zipcode
     * @return boolean
     */
    public static function is_zipcode($zipcode) {
        return preg_match('/^[1-9]\d{5}$/', $zipcode) ? true : false;
    }

    /**
     * 判断字母是否在某个区域内。用于判断某个字符只能介于[a-h](包含)之间的类似情况。
     * @param string $alpha 原值。
     * @param string $start_alpha 起始值。
     * @param string $end_alpha 截止值。
     * @return boolean
     */
    public static function alpha_between($alpha, $start_alpha, $end_alpha) {
        if (Validator::is_alpha($alpha) === false) {
            return false;
        }
        if (Validator::is_alpha($start_alpha) === false) {
            return false;
        }
        if (Validator::is_alpha($end_alpha) === false) {
            return false;
        }
        if ($start_alpha >= $end_alpha) {
            return false;
        }
        if ($alpha < $start_alpha) {
            return false;
        }
        if ($alpha > $end_alpha) {
            return false;
        }
        return true;
    }
    
    /**
     * 判断数字是否在某个区域之间。[2, 10],包含边界值。
     * @param int $value 原值。
     * @param int $start_value 起始值。
     * @param int $end_value 截止值。
     * @return boolean
     */
    public static function number_between($value, $start_value, $end_value) {
        if (is_numeric($value) === false || is_numeric($start_value) === false || is_numeric($end_value) === false) {
            return false;
        }
        if ($start_value >= $end_value) {
            return false;
        }
        if ($value < $start_value) {
            return false;
        }
        if ($value > $end_value) {
            return false;
        }
        return true;
    }

    /**
     * 验证是否为中文。
     * @param string $char
     * @return bool
     */
    public static function is_chinese($char) {
        if (strlen($char) === 0) {
            return false;
        }
        return (preg_match("/^[\x7f-\xff]+$/", $char)) ? true : false;
    }

    /**
     * 判断是否为字母、数字、下划线（_）、破折号（-）。
     * @param string $str
     * @return boolean
     */
    public static function is_alpha_dash($str) {
        return preg_match('/^([a-z0-9_-])+$/i', $str) ? true : false;
    }
    
    /**
     * 验证身份证号码是否合法。
     * @param string $vStr
     * @return bool
     */
    public static function is_idcard($vStr) {
        $vCity = array(
            '11','12','13','14','15','21','22',
            '23','31','32','33','34','35','36',
            '37','41','42','43','44','45','46',
            '50','51','52','53','54','61','62',
            '63','64','65','71','81','82','91'
        );
        if (!preg_match('/^([\d]{17}[xX\d]|[\d]{15})$/', $vStr)) {
            return false;
        }
        if (!in_array(substr($vStr, 0, 2), $vCity)) {
            return false;
        }
        $vStr = preg_replace('/[xX]$/i', 'a', $vStr);
        $vLength = strlen($vStr);
     
        if ($vLength == 18) {
            $vBirthday = substr($vStr, 6, 4) . '-' . substr($vStr, 10, 2) . '-' . substr($vStr, 12, 2);
        } else {
            $vBirthday = '19' . substr($vStr, 6, 2) . '-' . substr($vStr, 8, 2) . '-' . substr($vStr, 10, 2);
        }
        if (date('Y-m-d', strtotime($vBirthday)) != $vBirthday) {
            return false;
        }
        if ($vLength == 18) {
            $vSum = 0;
            for ($i = 17 ; $i >= 0 ; $i--) {
                $vSubStr = substr($vStr, 17 - $i, 1);
                $vSum += (pow(2, $i) % 11) * (($vSubStr == 'a') ? 10 : intval($vSubStr, 11));
            }
            if($vSum % 11 != 1) {
                return false;
            }
        }
        return true;
    }
    
    /**
     * 验证日期时间格式。
     * -- 1、验证$value是否为$format格式。
     * -- 2、只能验证格式，不能验证时间是否正确。比如：2014-22-22
     * @param string $format 格式。格式如：Y-m-d 或H:i:s
     * @param string $value 日期。
     * @return boolean
     */
    public static function is_date_format($format, $value) {
        return date_create_from_format($format, $value) !== false;
    }
    
    /**
     * 判断是否为整数。
     * @param string $str
     * @return boolean
     */
    public static function is_integer($str) {
        return filter_var($str, FILTER_VALIDATE_INT) !== false;
    }
    
    /**
     * 判断是否为字母数字。
     * @param string $str
     * @return boolean
     */
    public static function is_alpha_number($str) {
        return preg_match('/^([a-z0-9])+$/i', $str) ? true : false;
    }

    /**
     * 判断是否为字母。
     * @param string $str
     * @return boolean
     */
    public static function is_alpha($str) {
        return preg_match('/^([a-z])+$/i', $str) ? true : false;
    }
    
    /**
     * 验证IP是否合法。
     * @param string $ip
     * @return bool
     */
    public static function is_ip($ip) {
        return filter_var($ip, FILTER_VALIDATE_IP) !== false;
    }
    
    /**
     * 验证URL是否合法。
     * -- 合法的URL：http://www.baidu.com
     * @param string $url
     * @return bool
     */
    public static function is_url($url) {
        return filter_var($url, FILTER_VALIDATE_URL) !== false;
    }

    /**
     * 判断email格式是否正确。
     * @param string $email
     * @return bool
     */
    function is_email($email) {
        return filter_var($email, FILTER_VALIDATE_EMAIL) !== false;
    }

    /**
     * 是否必需。
     * @param string $str
     * @return bool
     */
    public static function is_require($str) {
        return strlen($str) ? true : false;
    }

    /**
     * 判断字符串是否为utf8编码，英文和半角字符返回ture。
     * @param string $string
     * @return bool
     */
    public static function is_utf8($string) {
        return preg_match('%^(?:
                    [\x09\x0A\x0D\x20-\x7E] # ASCII
                    | [\xC2-\xDF][\x80-\xBF] # non-overlong 2-byte
                    | \xE0[\xA0-\xBF][\x80-\xBF] # excluding overlongs
                    | [\xE1-\xEC\xEE\xEF][\x80-\xBF]{2} # straight 3-byte
                    | \xED[\x80-\x9F][\x80-\xBF] # excluding surrogates
                    | \xF0[\x90-\xBF][\x80-\xBF]{2} # planes 1-3
                    | [\xF1-\xF3][\x80-\xBF]{3} # planes 4-15
                    | \xF4[\x80-\x8F][\x80-\xBF]{2} # plane 16
                    )*$%xs', $string) ? true : false;
    }
    
    /**
     * 检查字符串长度。
     * @param string $str 字符串。
     * @param int $min 最小长度。
     * @param int $max 最大长度。
     * @param bool $is_utf8 是否UTF-8字符。
     * @return boolean
     */
    public static function len($str, $min = 0, $max = 255, $is_utf8 = false) {
        $len = $is_utf8 ? mb_strlen($str) : strlen($str);
        if (($len >= $min) && ($len <= $max)) {
            return true;
        } else {
            return false;
        }
    }
}

4.3 自动加载src目录

在4.2添加了src的加载运行composer install实现自动加载
➜  validator git:(master) ✗ composer install
Loading composer repositories with package information
Updating dependencies (including require-dev)
Nothing to install or update
Generating autoload files
此时目录中会生成一个vendor 它实现了加载方法
➜  validator git:(master) ✗ tree
.
├── README.md
├── composer.json
├── src
│   └── Validator.php
└── vendor
    ├── autoload.php
    └── composer
        ├── ClassLoader.php
        ├── LICENSE
        ├── autoload_classmap.php
        ├── autoload_namespaces.php
        ├── autoload_psr4.php
        ├── autoload_real.php
        ├── autoload_static.php
        └── installed.json

4.4 测试结果

创建test.php
<?php
require '../vendor/autoload.php';

use \DataTrans\Validator;

$mobilephone = '18665027895';
$ok = Validator::is_mobilephone($mobilephone);
if ($ok) {
    echo '是手机号码';
} else {
    echo '不是手机号码';
}
命令行中运行
➜  validator git:(master) ✗ php test.php
是手机号码

4.5 忽略vendor、composer.json文件

修改.gitignore增加下面两行
.vscode
/vendor/
composer.lock

4.6提交代码到 github

git add .
git commit -m "提交Validator扩展包"
git push origin master

5. Packagist配置

5.1 github关联到Packagist

首先要在Packagist上登录
点击顶部导航条中的Summit按钮
在输入框中输入github上的仓库地址，如：git@github.com:chendujin/validator.git
然后点击Check按钮
Packagist会去检测此仓库地址的代码是否符合Composer的Package包的要求
检测正常的话，会出现Submit按钮，再点击一下Submit按钮，我们的包就提交到Packagist上了

5.2 配置自动同步

从Packagist点击个人中心点击profile获取token然后复制
到github项目首页上点击settings、点击webhooks、点击addwebhook
把https://packagist.org/api/bitbucket?username=USERNAME&apiToken=TOKEN 复制到Payload URL，在下方输入密码后保存

四、引用包

composer require chendujin/validator

注意事项

如果下载不下来到话就换一下镜像
composer config -g repo.packagist composer https://packagist.laravel-china.org
刚发布上去可能会下载不到，没有同步过来– 可以等一会在试试看

Thomas

https://www.chendujin.cn/posts/5339145e.html

本博客所有文章除特別声明外，均采用 CC BY 4.0 许可协议。转载请注明来源 Thomas !

PHP composer

排序算法场景概念解读

2022-04-06 Go数据结构与算法常见算法

数据结构与算法

Go跨平台编译(交叉编译)

2022-03-25 Go入门基础其他

Go入门基础编译

实现自己的Composer包

一、Composer简介

二、准备工作

三、发布流程

1.首先在github上创建一个项目

2.把项目克隆到本地

3.进入项目根目录初始化项目

4.编写自己的composer包

4.1 此处我创建了一个src目录并实现了Validator类

4.2 Validator类

4.3 自动加载src目录

4.4 测试结果

4.5 忽略vendor、composer.json文件

4.6提交代码到 github

5. Packagist配置

5.1 github关联到Packagist

5.2 配置自动同步

四、引用包

注意事项

你的赏识是我前进的动力