https://github.com/php-ds/ext-ds

An extension providing efficient data structures for PHP 7
https://github.com/php-ds/ext-ds

data-structures extension pecl php php-7

Last synced: about 1 month ago
JSON representation

An extension providing efficient data structures for PHP 7

• Host: GitHub
• URL: https://github.com/php-ds/ext-ds
• Owner: php-ds
• License: mit
• Created: 2016-02-01T08:05:07.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2024-02-28T16:54:26.000Z (7 months ago)
• Last Synced: 2024-07-28T16:18:07.158Z (about 2 months ago)
• Topics: data-structures, extension, pecl, php, php-7
• Language: C
• Homepage: https://medium.com/p/9dda7af674cd
• Size: 1.03 MB
• Stars: 2,106
• Watchers: 91
• Forks: 94
• Open Issues: 25
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-php-extensions - ds - 标准数据结构 (数据转换)

README

        
# Native Data Structures for PHP

[![Build Status](https://github.com/php-ds/ext-ds/workflows/CI/badge.svg)](https://github.com/php-ds/ext-ds/actions?query=workflow%3A%22CI%22+branch%3Amaster)

[![Build status](https://ci.appveyor.com/api/projects/status/9w0xitp3q04hdu1d?svg=true)](https://ci.appveyor.com/project/rtheunissen/ext-ds)

[![PECL](https://img.shields.io/badge/PECL-1.5.0-blue.svg)](https://pecl.php.net/package/ds)

A PHP language extension that provides specialized data structures as efficient alternatives to the PHP array.

You can read about it in more detail [in this blog post](https://medium.com/p/9dda7af674cd) which highlights the API, performance (relative to PHP 7) and other benefits of using the extension.

## Documentation

Documentation is available on [php.net](http://docs.php.net/manual/en/book.ds.php). You should also include the [polyfill](https://github.com/php-ds/polyfill) in your project for IDE integration.

## Installation

The easiest way to install the extension is to use PECL:

```

pecl install ds

```

If you're on Windows, you can download a compiled .dll on [PECL](https://pecl.php.net/package/ds) or under [releases](https://github.com/php-ds/extension/releases).

## Enabling the extension

You'll need to add `extension=ds.so` to your primary *php.ini* file.

If you encounter an "undefined symbol" error, see [#2](https://github.com/php-ds/extension/issues/2#issuecomment-181855047).

```bash

# To see where .ini files are located

php -i | grep "\.ini"

```

---

You can also enable the extension temporarily using the command line:

```bash

php -d extension=ds.so

```

**Note**: Windows would use php_ds.dll instead.

## Testing

There is a suite of PHPUnit tests that can be installed using [**Composer**](https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx).

``` bash

composer install   # Install the test suite

composer test      # Run the tests

composer memtest   # Run the tests checking for memory leaks

```

## Compatibility

You may include the [polyfill](https://github.com/php-ds/polyfill) as a dependency in your project. This allows your codebase to still function in an environment where the extension is not installed.

## Contributing

For local development, I'm using Docker:

```

./dev.sh  # opens a shell into a development environment

phpize

./configure

make

make install

composer install

composer test

```

Please see [CONTRIBUTING](CONTRIBUTING.md) for more information.

## Credits

- [Rudi Theunissen](https://github.com/rtheunissen)

- [Joe Watkins](https://github.com/krakjoe)

## License

The MIT License (MIT). Please see [LICENSE](LICENSE) for more information.