SPSS / PSPP

A PHP library for reading and writing SPSS / PSPP .sav data files.

VERSION 3.* (see upgrade section for details)

Requirements

PHP 7.2, 7.3 and up.

Installation

The preferred way to install this extension is through composer

Either run

composer require flobee/spss

to the require section of your composer.json file see here or download from here.

Usage

Reader example:

$reader = \SPSS\Sav\Reader::fromFile('path/to/file.sav');

$reader = \SPSS\Sav\Reader::fromString(file_get_contents('path/to/file.sav'));

Writer example:

$writer = new \SPSS\Sav\Writer([
    'header' => [
            'prodName'     => '@(#) SPSS DATA FILE test',
            'layoutCode'   => 2,
            'compression'  => 1,
            'weightIndex'  => 0,
            'bias'         => 100,
            'creationDate' => '13 Feb 89',
            'creationTime' => '23:58:59',
    ],
    'variables' => [
        [
                'name'     => 'VAR1',
                'width'    => 0,
                'decimals' => 0
                'format'   => 5,
                'columns'  => 50,
                'align'    => 1,
                'measure'  => 1,
                'data'     => [
                    1, 2, 3
                ],
        ],
        ...
    ]
]);

Demo/ playground

cd tests

php readerDemo.php | less
# or to update tmp file to check for changes (using a diff):
php readerDemo.php > data/pspp.sav.printr.txt

Tests / Developers

Install using shell:

git clone https://github.com/flobee/spss.git
cd spss/
git submodule init # once
git submodule update --recursive # upgrading (after a `git pull`)

Initialy or for upgrades to get development dependencies:

composer install

then (base demo data at tests/data/pspp.sav will be used):

VERSION 3.* (Improved additions for CI systems)

# shows you the options
./phing -l

# executes the tests
./phing test

# executes the tests and create the code coverage
./phing coverage

# run all tasks (CS checks, coverage, tests)
./phing all

...

VERSION 2.*

cd tests 
sh ./runTests.sh

php readerDemo.php | less
# or to update tmp file to check for changes:
php readerDemo.php > data/pspp.sav.printr.txt

running tests:

cd tests
sh ./runTests.sh

# have a look at ../docs/CodeCoverage (use a browser after execution)
sh ./runCoverage.sh

Upgrade to version 3.*

Update your composer.json

{
    ...
    "require": {
        "flobee/spss": "3.*",
    },
    ...
}

composer update flobee/spss

Dependency Errors?

If you get dependency errors, you may upgrade other spss dependencies too. If so try the following:

composer update flobee/spss --with-dependencies

Changelog

Please have a look in docs/CHANGELOG.md

License

Licensed under the MIT license.

rvntone/spss