Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/astronin/eexcelread
Yii extention. Read excel file and save to DB
https://github.com/astronin/eexcelread
Last synced: 9 days ago
JSON representation
Yii extention. Read excel file and save to DB
- Host: GitHub
- URL: https://github.com/astronin/eexcelread
- Owner: AstRonin
- License: other
- Created: 2012-09-20T05:26:41.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2013-08-13T08:28:01.000Z (about 11 years ago)
- Last Synced: 2023-03-29T19:21:57.899Z (over 1 year ago)
- Language: PHP
- Homepage:
- Size: 105 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
EExcelRead
====================
Read excel file and save to DB.
Based on PHPExcel [http://www.codeplex.com/PHPExcel](http://www.codeplex.com/PHPExcel) (version 1.7.7, 2012-05-19)
##Requirements:
* PHP 5.2 +
* [Yii](http://yiiframework.com) 1.1 or above
* Extension used model [ActiveRecord](http://www.yiiframework.com/doc/guide/1.1/en/database.ar)
* [PHPExcel](http://www.codeplex.com/PHPExcel) library
##Installation
Copy EExcelRead.php to:
/protected/extensions/phpexcel/ or else
Add PHPExcel lybrary to:
/protected/extensions/phpexcel/Classes/ or else
##Usage
###Simple exemple:
```php
widget('ext.phpexcel.EExcelRead', array(
'inputFileName'=>'example1.xls',
'modelString'=>'User',
));
```
In this case model's properties will be fill in the same order as in excel file.
Be careful, if not use 'modelFields' order fields in file must be equal order fields in model.
####Very simple exemple:
#####If use this method [How to upload a file using a model](http://www.yiiframework.com/wiki/2/):
```php
widget('ext.phpexcel.EExcelRead', array(
'model'=>$this,
'modelPropertyIncludeFile'=>'field_upload_file'
));
```
OR
```php
widget('ext.phpexcel.EExcelRead', array(
'model'=>$this,
));
```
In this case extension will find required field in the model.
###Configuration:
* libPath - The path to the PHP excel lib
default: ext.phpexcel.Classes.PHPExcel
* inputFileType - If empty then type will be found automatically
suported types: 'Excel2007','Excel5','Excel2003XML','OOCalc','SYLK','Gnumeric'
default: empty string
* inputFileName - Name of excel file
* skipRows - You can skip row(s). Supported types: boolean|int|array (not string).
boolean = true - that skiped first row.
int - that skiped one row. Int must be set exactly as in the file. First row = 1
array - that skiped each row from array. array(1,5,69)
* modelString - Name of Model. String.
* model - The model instance. Object.
Can set modelString as string or model as object or both.
```php
...
'modelString' => 'MyModel',
'model'=>$this, // new MyElseModel() if use another model
...
```
* modelPropertyIncludeFile - Extension will try find file in model property if upload file will be through model. See CUploadedFile
```php
...
'model'=>$this,
'modelPropertyIncludeFile'=>'field_upload_file'
...
```
* modelDefaultFields - Fill fields static data which not set in the file or replace existing
```php
...
'modelDefaultFields'=>array(
'user_id'=>10,
'visible'=>true,
),
...
```
* modelFields - Array of model properties, sequence by DB's table.
if array's value = 0|''|null|false, not action under this field
```php
...
'modelFields'=>array(
'',
'name',
'age',
'comm',
),
...
```
Add field 'id' for update row in the DB and if excel has identification field(like ID)
```php
...
'modelFields'=>array(
'id',
'name',
...
),
...
```
If excel have fild from other model:
```php
...
'modelFields'=>array(
'name',
...
'post'=>array(
'class'=>'Post',
'relationKey'=>'user_id',
'defaultValues'=>array('visible'=>1),
),
'address'=>array(
'class'=>'Adress',
'relationKey'=>'user_id',
),
...
),
...
```
class - Name of relation model.
relationKey - Surrogate key.
defaultValues - works like as 'modelDefaultFields'.
* useRowAsModelFields - Use first (or else) row from the excel file as model fields
Type: boolean | int
If set TRUE selected first row. Integer must be set exactly as in the file!
Attention! List of fields in the modelFields has a higher priority. If filled modelFields
that useRowAsModelFields is ignored.
default = false
* onBeforeSave - Call function before save.
* onAfterSave - Call functon after save
'MyMethod' | array($this,'MyMethod') | array('MyClass', 'MyMethod')
Exemple: 'onBeforeSave'=>array($this,'uploadCallbackBeforeSave'),
##Change Log
Version 0.4 (21.09.2012)
* Add new property: modelPropertyIncludeFile, model
* Change work of property: modelString, now only as string
* Add automatic manipulation with file used CUploadedFile
* Add two methods of simple start the extension
* Bug fixing...
PS: Extension is written after using EExcelView (unashamedly taken the idea of callbacks).