README

操作csv文件的简单PHP库。

内容

• 需求
• 安装
• 使用方法
• 示例
• 授权协议

需求

• PHP 8.0.0 (CLI) 或更高版本
• Composer

安装

composer require macocci7/php-csv

使用方法

• PHP

  <?php
  
  require_once('../vendor/autoload.php');
  
  use Macocci7\PhpCsv\Csv;
  
  // load a csv
  $filename = 'csv/weather_tokyo_2023nov_sjis.csv';
  $csv = new Csv($filename);
  
  // encode data and save it
  $csv->encode('SJIS', 'UTF-8')->save('csv/weather_tokyo_2023nov_utf8.csv');
  
  // properties
  echo sprintf(
      "Filename:[%s], %d rows, %d columns.\n\n",
      $filename,
      $csv->countRows(),
      $csv->countColumns()
  );
  
  // retrieve a row
  echo sprintf("%s\n\n", implode(', ', $csv->row(5)));
  
  // offset of rows for column()
  $csv->offsetRow(7);
  
  // retrieve columns: Date & Max temprature & Min temprature
  echo sprintf("%s\n\n", implode(', ', $csv->string()->column(1)));
  echo sprintf("%s\n\n", implode(', ', $csv->float()->column(2)));
  echo sprintf("%s\n\n", implode(', ', $csv->int()->column(2)));
  echo sprintf("%s\n\n", implode(', ', $csv->bool()->column(2)));
  echo sprintf("%s\n\n", implode(', ', $csv->raw()->column(2)));

• 结果

  Filename:[csv/weather_tokyo_2023nov_sjis.csv], 38 rows, 27 columns.
  
  年月日, 平均気温(℃), 平均気温(℃), 平均気温(℃), 最高気温(℃), 最高気温(℃), 最高気温(℃), 最低気温(℃), 最低気温(℃), 最低気温(℃), 日照時間(時間), 日照時間(時間), 日照時間(時間), 日照時間(時間), 降水量の合計(mm), 降水量の合計(mm), 降水量の合計(mm), 降水量の合計(mm), 平均蒸気圧(hPa), 平均蒸気圧(hPa), 平均蒸気圧(hPa), 平均現地気圧(hPa), 平均現地気圧(hPa), 平均現地気圧(hPa), 平均雲量(10分比), 平均雲量(10分比), 平均雲量(10分比)
  
  2023/10/1, 2023/10/2, 2023/10/3, 2023/10/4, 2023/10/5, 2023/10/6, 2023/10/7, 2023/10/8, 2023/10/9, 2023/10/10, 2023/10/11, 2023/10/12, 2023/10/13, 2023/10/14, 2023/10/15, 2023/10/16, 2023/10/17, 2023/10/18, 2023/10/19, 2023/10/20, 2023/10/21, 2023/10/22, 2023/10/23, 2023/10/24, 2023/10/25, 2023/10/26, 2023/10/27, 2023/10/28, 2023/10/29, 2023/10/30, 2023/10/31
  
  25.6, 23.3, 22.8, 18.7, 20, 20.8, 20.4, 18.1, 15.4, 20.2, 19.8, 19.4, 18.5, 18.2, 14.9, 19, 19.5, 18.9, 20.3, 21.8, 19, 15.9, 16.7, 17.7, 17.7, 16.9, 17.8, 17.5, 16.3, 16.9, 17.2
  
  25, 23, 22, 18, 20, 20, 20, 18, 15, 20, 19, 19, 18, 18, 14, 19, 19, 18, 20, 21, 19, 15, 16, 17, 17, 16, 17, 17, 16, 16, 17
  
  1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
  
  25.6, 23.3, 22.8, 18.7, 20.0, 20.8, 20.4, 18.1, 15.4, 20.2, 19.8, 19.4, 18.5, 18.2, 14.9, 19.0, 19.5, 18.9, 20.3, 21.8, 19.0, 15.9, 16.7, 17.7, 17.7, 16.9, 17.8, 17.5, 16.3, 16.9, 17.2
  
  

方法

• load(): 加载由参数指定的csv文件
• save(): 将数据保存到由参数指定的csv文件中
• encode(): 编码已加载的csv数据
• countRows(): 返回csv的行数
• countColumns(): 返回csv的最大列数
• bool(): 为column()指定类型转换为(bool)
• int(): 为column()指定类型转换为(int)
• float(): 为column()指定类型转换为(float)
• string(): 为column()指定类型转换为(string)
• raw(): 取消column()的类型转换
• offsetRow(): 指定column()的行偏移量
• row(): 以数组形式检索指定的行
• column(): 以数组形式检索指定的列
• dump(): 返回所有数据作为csv
• dumpArray(): 返回所有数据作为数组

示例

• UseCsv.php 生成结果 >> UseCsv.txt

授权协议

MIT

文档创建于2023/11/10

文档更新于2023/11/15