更新说明文档

zhao.binyan · zhao.binyan · commit 057e6f0daf2c · 2020-11-07T01:19:07.000+08:00
diff --git a/LICENSE b/LICENSE
@@ -17,3 +17,28 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
+
+======================================================================================================================================================================================================
+ip-database 协议简述
+
+1，可以自由使用解析程序，但务必在程序内标明来源。https://github.com/itbdw/it-database
+2，不保证任何准确性，应当知晓方可使用
+3，仅供学习和娱乐用，如被用作违法事宜，本人均不承担任何责任
+4，其它合理性解释权利归本人所有
+
+======================================================================================================================================================================================================
+
+纯真IP地址数据库 License
+
+本协议是用户（您）和纯真网络（cz88.net）之间关于使用纯真IP地址数据库（本数据库）达成的协议。您安装或者使用本数据库的行为将视为对本协的接受及同意。除非您接受本协议，否则请勿下载、安装或使用本数据库，并请将本数据库从计算机中移除。
+
+1. 本数据库是免费许可软件，不进行出售。你可以免费的复制，分发和传播本数据库， 但您必须保证每一份复制、分发和传播都必须是未更改过的，完整和真实的。
+2. 您作为个人使用本数据库。您只能对本数据库进行非商业性的应用。
+3. 任何免费软件以及非商业性网站均可无偿使用本数据库，但在其说明上均应注明本数据库的名称和来源为“纯真IP地址数据库”。
+4. 本数据库为免费共享软件。我们对本数据库产品不提供任何保证，不对任何用户因本数据库所遭遇到的任何理论上的或实际上的损失承担责任，不对用户使用本数据库造成的任何后果承担责任。
+5. 本数据库所收集的信息，均是从网上收集而来。数据库只包含IP与其对应的地址，但是这些数据不会涉及您的个人信息，因此也不会侵害您的隐私。
+6. 欢迎任何人为我们提供正确详尽的IP地址。可登陆纯真网站（http://www.cz88.net/ip）或论坛（http://bbs.cz88.net）提交正确的IP与地址，以便我们修正并提高本数据库IP地址数据的准确性。
+
+            纯真网络（cz88.net）版权所有，保留一切解释权利 !
+
+
diff --git a/README.md b/README.md
@@ -1,18 +1,16 @@
-# 免费IP数据库 (纯真IP库，已经格式为国家、省、市、县、运营商)
+# 说明
 
-此工具基于纯真 IP 库，并且把非结构化的数据结构化。
+这套识别程序的数据库是免费IP数据库、IP离线地址库。输入IP，输出结构化的国家、省、市、县、运营商、地区信息)
 
-一旦识别了 IP，都可以显示国家。国内 ip 都能识别出省，基本可以识别出市、运营商，有部分能识别出县，以及公司小区学校网吧等信息。
+0，该数据库识别是离线的。
+1，该数据库基于纯真IP库，IP地址纠错相关请直接去纯真官网，下面有给出地址。纯真IP地址库，不可以用作商业用途，具体见 LICENSE。
+2，纯真IP识别算法来源网络。
+3，结构化程序来自我2012年的脑洞。
 
-## 环境要求
-
-只需要 php 环境即可本地解析 ip。
-不需要网络请求。
-第一次查询即读入内存，以后直接从内存读取，效率非常高。
+纯真IP已从03年开始存在多年且一直免费，实属不易。因为数据存储时，并不是结构化的，因此有误差在所难免。这个结构化程序，国内 ip 可以识别出省份，基本可以识别出市。运营商、县数据看运气。
 
-## 数据库文件更新日期
-
-2019年8月20日更新
+## 环境要求
+PHP5即可，本地安装，无网络依赖，只需要 php 环境即可本地解析 ip。
 
 ## 使用说明
 
@@ -22,21 +20,23 @@ composer require 'itbdw/ip-database'
 
 ```php
 
-//根据实际情况，基本上用框架（如 Laravel）的话不需要手动引入
+//用框架（如 Laravel）不需要手动引入
 //require 'vendor/autoload.php';
 
 use itbdw\Ip\IpLocation;
 
 //支持自定义文件路径
 $qqwry_filepath = '/abspath/qqwry.dat';
 echo json_encode(IpLocation::getLocation($ip, $qqwry_filepath), JSON_UNESCAPED_UNICODE) . "\n";
+
+//直接用附带的版本
 echo json_encode(IpLocation::getLocation($ip), JSON_UNESCAPED_UNICODE) . "\n";
 
 ```
 
 ## 响应
 
-获取成功
+成功
 ```json
 {
   "ip": "163.177.65.160",
@@ -66,7 +66,7 @@ php tests/ip.php -i 58.196.128.0
 
 ```
 
-## 典型返回
+## 典型返回示例
 ```
 {"ip":"172.217.25.14","country":"美国","province":"","city":"","county":"","isp":"","area":"美国加利福尼亚州圣克拉拉县山景市谷歌公司"}
 {"ip":"140.205.172.5","country":"中国","province":"浙江","city":"杭州市","county":"","isp":"","area":"中国浙江杭州市阿里巴巴网络有限公司BGP数据中心"}
@@ -77,7 +77,10 @@ php tests/ip.php -i 58.196.128.0
 
 ## 更新数据库
 
-### 在线直接更新
+### 附带的数据库文件更新日期
+2020年9月30日更新
+
+### 在线直接更新（暂时无效，带宽压力）
 
 更新到源码目录
 `php ~/bin/update-ip.php`
@@ -87,22 +90,29 @@ php tests/ip.php -i 58.196.128.0
 
 ### 【或者】自己手动更新数据库
 
-1，http://www.cz88.net/ip/
-下载数据库程序（Windows 环境），执行完毕后，即可在程序安装目录找到数据库文件 qqwry.dat
+http://www.cz88.net/ip/ 下载数据库程序（Windows 环境），执行完毕后，即可在程序安装目录找到数据库文件 qqwry.dat 覆盖即可。
 
-2，复制到 src 目录，覆盖掉原文件即可；或者，把文件同步到服务器特定路径，但这种方式要求调用方法时传入
- qqwry.dat 的绝对路径。
+## 赞赏
+这个项目也是多个日夜思考的结果，如果觉得对你有帮助，小手一抖也是感谢的。
+![img](https://wx1.sinaimg.cn/large/6b94a2e5ly1gjoqqrkup8j20u00u0wh1.jpg)
 
-## 数据库来源
+## 感谢
+1，纯真IP库，站长维护多年，实属不易，烦请有能力的客观前往官方站点给站长赞赏 http://www.cz88.net/ip/
+
+## 其它 IP 数据库推荐
 
-纯真IP库，站长不易，烦请有能力的可以给纯真IP作者适当打赏 http://www.cz88.net/ip/
+如果这个不能满足，可以参考各种免费、收费数据库。
 
+1，比较推荐高春辉维护的，有免费版本 http://www.ipip.net/index.html
+2，阿里云昂贵的数据库 https://www.aliyun.com/product/dns/geoip
 
-## update log
+## 更新日志
 
 ```
  IP 地理位置查询类
  
+ 2020-11-07 赵彬言 		1，只是更新文档，更新数据库。无它。自动更新暂时无法使用。
+ 
  2019-07-25 赵彬言         1，增加自动更新功能，参考 https://blog.shuax.com/archives/QQWryUpdate.html 感谢 https://github.com/itbdw/ip-database/issues/10
  
  2017-09-12 赵彬言         1，缩减返回数据，去掉字段 remark smallarea beginip endip
@@ -130,14 +140,3 @@ php tests/ip.php -i 58.196.128.0
 
 ```
 
-## 其它 IP 数据库推荐
-
-国内的
-
-http://www.ipip.net/index.html
-
-国际的
-
-https://dev.maxmind.com/zh-hans/geoip/geoip2/geolite2-%E5%BC%80%E6%BA%90%E6%95%B0%E6%8D%AE%E5%BA%93/
-
-
diff --git a/composer.json b/composer.json
@@ -1,21 +1,19 @@
 {
   "name": "itbdw/ip-database",
   "type": "library",
-  "description": "免费IP数据库，IP 地址库(纯真IP地址库，输出格式为国家、省、市、县、运营商)❤️ 🇨🇳，中文数据库，方便实用",
+  "description": "免费IP地址数据库(纯真IP地址数据库，输出格式为国家、省、市、县、运营商)❤️ 🇨🇳，中文数据库",
   "keywords": [
     "ip",
     "database",
     "location",
     "数据库",
     "IP地址库",
-    "IP数据库"
-    "纯真",
+    "IP数据库",
+    "纯真IP地址库",
+    "qqwry"
   ],
   "license": "MIT",
   "authors": [
-    {
-      "name": "马秉尧"
-    },
     {
       "name": "itbdw",
       "email": "itbudaoweng@gmail.com",
diff --git a/src/IpLocation.php b/src/IpLocation.php
@@ -2,11 +2,10 @@
 /**
  * IP 地理位置查询类
  *
- * @author    马秉尧，赵彬言<itbudaoweng@gmail.com>
+ * @author    赵彬言<itbudaoweng@gmail.com>
  * @version   2.0
- * @copyright 2005 CoolCode.CN，2012-2019 itbdw.com
+ * @copyright 2012-2021 itbdw.com
  */
-
 namespace itbdw\Ip;
 
 /**
@@ -21,7 +20,7 @@ class IpLocation {
     private static $instance;
 
     /**
-     * qqwry.dat文件指针
+     * qqwry.dat 文件指针
      *
      * @var resource
      */
@@ -59,7 +58,7 @@ class IpLocation {
         '铁通',
         '电信',
         '长城',
-        '聚友',
+        '鹏博士',
     ];
 
     /**
diff --git a/src/qqwry.dat b/src/qqwry.dat
