Merge pull request #597 from tioncico/3.3.x

kiss291323003 · web-flow · commit 751077ee3f15 · 2020-01-14T12:41:55.000+08:00
增加开源项目推荐章节
diff --git a/docs/.vuepress/public/resources/openSource/xlsWriter.png b/docs/.vuepress/public/resources/openSource/xlsWriter.png
diff --git a/docs/.vuepress/sidebar.js b/docs/.vuepress/sidebar.js
@@ -212,6 +212,23 @@ const sidebarCn = [
             ['/Components/console', '远程控制台'],
         ]
     },
+    {
+        title: '基础使用',
+        collapsable: true,
+        sidebarDepth: 0,
+        children: [
+            ['/BaseUsage/serverManager', 'Swoole实例'],
+            ['/BaseUsage/customCommand', '自定义命令'],
+            ['/Components/Component/process', '自定义进程'],
+            ['/BaseUsage/event', '自定义事件'],
+            ['/Components/task', 'Task 异步任务'],
+            ['/Components/Component/timer', 'Timer 定时器'],
+            ['/BaseUsage/crontab', 'Crontab 计划任务'],
+            ['/BaseUsage/log', '日志处理'],
+            ['/Components/phpunit', '单元测试'],
+            ['/Components/console', '远程控制台'],
+        ]
+    },
     {
         title: 'HTTP服务',
         collapsable: true,
@@ -670,7 +687,15 @@ const sidebarCn = [
             ['/Other/chromeHeadless', 'ChromeHeadless'],
             ['/Other/graphQL', 'GraphQL'],
         ]
-    }
+    },
+    {
+        title: '开源项目推荐',
+        collapsable: true,
+        sidebarDepth: 0,
+        children: [
+            ['/OpenSource/xlsWriter', 'xlsWriter-excel解析项目'],
+        ]
+    },
 ];
 const sidebarEn = [
   {
diff --git a/docs/OpenSource/xlsWriter.md b/docs/OpenSource/xlsWriter.md
@@ -0,0 +1,69 @@
+## xlsWriter-excel解析项目
+
+![logo](https://github.com/viest/php-ext-xlswriter/raw/master/resource/logo_now.png)  
+
+## 项目介绍
+
+### 为什么使用xlswriter
+
+请参考下方对比图；由于内存原因，PHPExcel数据量`相对较大`的情况下无法正常工作，虽然可以通过`修改memory_limit`配置来解决内存问题，但完成工作的时间可能会更长;
+
+![php-excel](https://github.com/viest/php-ext-xlswriter/raw/master/resource/performance_comparison.png)
+
+xlswriter是一个 PHP C 扩展，可用于在 Excel 2007+ XLSX 文件中读取数据，插入多个工作表，写入文本、数字、公式、日期、图表、图片和超链接。
+
+它具备以下特性：
+
+###### 一、写入
+
+* 100％兼容的Excel XLSX文件
+* 完整的Excel格式
+* 合并单元格
+* 定义工作表名称
+* 过滤器
+* 图表
+* 数据验证和下拉列表
+* 工作表PNG/JPEG图像
+* 用于写入大文件的内存优化模式
+* 适用于Linux，FreeBSD，OpenBSD，OS X，Windows
+* 编译为32位和64位
+* FreeBSD许可证
+* 唯一的依赖是zlib
+
+###### 二、读取
+
+* 完整读取数据
+* 光标读取数据
+* 按数据类型读取
+
+#### 基准测试
+
+测试环境: Macbook Pro 13 inch, Intel Core i5, 16GB 2133MHz LPDDR3 Memory, 128GB SSD Storage.
+
+##### 导出
+
+> 两种内存模式导出100万行数据（单行27列，数据类型均为字符串，单个字符串长度为19）
+
+* 普通模式：耗时 `29S`，内存只需 `2083MB`；
+* 固定内存模式：仅需 `52S`，内存仅需 `<1MB`；
+
+##### 导入
+
+> 100万行数据（单行1列，数据类型为INT）
+
+* 全量模式：耗时 `3S`，内存仅 `558MB`；
+* 游标模式：耗时 `2.8S`，内存仅 `<1MB`；
+
+## 从这里开始
+
+[文档|Documents](https://xlswriter-docs.viest.me/)
+
+## PECL 仓库
+
+[![pecl](https://github.com/viest/php-ext-xlswriter/raw/master/resource/pecl.png)](https://pecl.php.net/package/xlswriter)
+
+## IDE Helper
+
+```bash
+composer require viest/php-ext-xlswriter-ide-helper:dev-master
+```
