Net_Sieve

Handles talking to a sieve server.

Download latest release 1.4.8 (there might be newer Composer installable version)

License: BSD

Description

This package provides an API to talk to servers implementing the managesieve protocol. It can be used to install and remove sieve scripts, mark them active etc.

Maintainers

Aleksander Machniak (alec) — lead, active
Jan Schneider (yunosh) — lead, inactive
Richard Heyes (richard) — lead, inactive
Damian Fernandez Sosa (damian) — lead, inactive
Anish Mistry (amistry) — lead, inactive

Dependencies

Required

PHP (>= 5.6.0)
PEAR Installer (>= 1.4.0b1)
Net_Socket (>= 1.0)

Optional

Auth_SASL (>= 1.0)

Releases

1.4.8 (stable, 2025-10-22)
Release notes

License: BSD

* Fixed OAUTHBEARER support
* Fixed various PHP deprecation warnings
* PHPDoc fixes
1.4.7 (stable, 2024-04-08)
Release notes

License: BSD

* Add support of OAUTHBEARER
* PHPDoc improvements/fixes
* Short array syntax
1.4.6 (stable, 2022-12-02)
Release notes

License: BSD

* Fix PHP 8.1 deprecation warnings
1.4.5 (stable, 2021-04-24)
Release notes

License: BSD

* Support XOAUTH2 authorization method
1.4.4 (stable, 2018-09-09)
Release notes

License: BSD

* Fix PHP 7.3: Declaration of case-insensitive constants is deprecated
1.4.3 (stable, 2018-03-04)
Release notes

License: BSD

* Support GSSAPI authentication
1.4.2 (stable, 2018-02-14)
Release notes

License: BSD

* Composer: Fix license identifier, don't use unbound version numbers for deps
1.4.1 (stable, 2017-05-26)
Release notes

License: BSD

* Use 8bit instead of latin1 for string length in bytes calculation
* Extend listScripts() so it's possible to get an active script name in one go
* Request #20491: Skip redundant CAPABILITY requests
1.4.0 (stable, 2017-05-21)
Release notes

License: BSD

* Dropped PHP4 support, fixed PHP7 warnings
* Fixed E_DEPRECATED warning on Auth_SASL::factory() call
* Enable later TLS versions
1.3.4 (stable, 2015-01-20)
Release notes

License: BSD

* Remove erroneous and unnecessary active script caching (Bug #20472).
1.3.3 (stable, 2014-09-26)
Release notes

License: BSD

* Fix notices from non-static calling of PEAR methods.
* Fix reading OK responses with string literal messages.
1.3.2 (stable, 2011-08-06)
Release notes

License: BSD

* Fix referrals if host data or user credentials are passed to connect() and login() instead of the constructor (Aleksander Machniak, Bug #17107).
1.3.1 (stable, 2011-08-06)
Release notes

License: BSD

* Query capabilities again after successful authentication (Jesse Crawford, Request #18382).
* Escape quotes and backslashes in script names, and use literal strings for script names with non-ASCII characters (Aleksander Machniak, Bug #16691).
* Work around broken STARTTLS behavior in Cyrus versions before 2.3.10 (Aleksander Machniak, Bug #18241).
* Improve string literal parsing (Aleksander Machniak, Bug #18228).
1.3.0 (stable, 2010-07-01)
Release notes

License: BSD

* Add debug handler parameter to constructor.
* Fix LOGIN authentication (Agustín Eijo, Aleksander Machniak, Bug #17527).
1.2.2 (stable, 2010-06-13)
Release notes

License: BSD

* Fix SASL authentication without Auth_SASL (Bug #17489).
1.2.1 (stable, 2010-04-19)
Release notes

License: BSD

* Fix DIGEST-MD5 authentication with Dovecot (Stef Simoens, Bug #17320).
1.2.0 (stable, 2010-04-01)
Release notes

License: BSD

Changes since version 1.2.0b1:
* Fix DIGEST-MD5 authentication (Aleksander Machniak, Bug #17285).
* Don't try to call dl() if mbstring extension isn't loaded (Bug #17038).
Changes since version 1.1.7:
* Added support for adding a custom debug handler (Aleksander Machniak, Request #16681).
* Fix breakage with certain locales, especially Turkish.
* Fix reading authentication responses without literals (Bug #16647).
* Code cleanup.
1.2.0b1 (beta, 2009-10-08)
Release notes

License: BSD

* Added support for adding a custom debug handler (Aleksander Machniak, Request #16681).
* Fix breakage with certain locales, especially Turkish.
* Fix reading authentication responses without literals (Bug #16647).
* Code cleanup.
1.1.7 (stable, 2009-07-24)
Release notes

License: BSD

* Fixed STARTTLS support (Bug #14205).
* Added connect options and EXTERNAL authentication.
1.1.6 (stable, 2008-03-22)
Release notes

License: BSD

* Fixed Bug #9273
* Fixed copy/paste error in CRAM and DIGEST authentication error case.
1.1.5 (stable, 2006-10-24)
Release notes

License: BSD

* Fixed Bug connect() bug
* Fixed Request #8071
1.1.4 (stable, 2006-09-09)
Release notes

License: BSD

* Fixed Bug #8452 Unterminated read loop
* Fixed Bug #7845 Add mbstring support
* Added Request #8071 Enable the ability to toggle TLS support if available.
* Added Request #8453 Clean up PHPDoc and comments
1.1.3 (stable, 2006-05-21)
Release notes

License: BSD

* Correctly Fixed Bug #3519 Net_Sieve w/ externally established sockets
* Fixed Bug #7197 getScript() truncates long scripts
* Added PHPUnit2 regression test script
1.1.2 (stable, 2006-02-09)
Release notes

License: BSD

* Fixed Request #4053 Added STARTTLS support for PHP 5.1 and above
* Fixed Bug #3519 Net_Sieve w/ externally established sockets
* Fixed Bug #4794 drops protocol prefix, e.g. "ssl://" in referrals
* Fixed STARTTLS detection
* Allow $options[] to be passed to Net_Socket
1.1.1 (stable, 2005-02-02)
Release notes

License: BSD

* Fixed Bug #3242 cyrus murder referrals not followed
1.1.0 (stable, 2004-12-18)
Release notes

License: BSD

* Fixed Bug #2728 Linebreaks not being read using getScript()
1.0.1 (stable, 2004-03-13)
Release notes

License: BSD

* Fixed BUG #1006
1.0.0 (stable, 2004-03-09)
Release notes

License: BSD

* Fixed DIGEST-MD5 sasl version handling (sasl v1.xx responses are diferent than v2.xx)
* Fixed LOGIN Method
0.9.2 (stable, 2004-03-01)
0.9.1 (stable, 2004-02-29)
Release notes

License: BSD

* There is an issue whith the DIGEST-MD5 method. in one installation it does not work but in my server it works perfect! please send me debug info to solve the problem if
it affects you or disable DIGEST-MD5
* some optimizations to the code
* added haveSpace() to check if the server has space to store the script. Use with care HAVESPACE seems to be broken in cyrus 2.0.16
* added hasExtension()
* added getExtensions()
* added referral support and automatic following of them. (it also handles the following of multireferrals).
* removed _getResponse replaced by _doCmd. (thanks to Etienne Goyer for this)
* added supportsAuthMech()
* if installed automatically uses Auth_SASL
* added CRAM-MD5 auth Method
* added DIGEST-MD5 auth Method
* added getAuthMechs() returns an array containing all the auth methods the server supports
* added hasAuthMech() to check if the server has a particular auth method
* _connect --> connect: now is a public method (without breaking BC)
* _login --> login: now is a public method (without breaking BC)
* fix typo cmdAuthenticate() ---> _cmdAuthenticate()
* _doCmd() now parses string responses also.
0.9.0 (stable, 2004-01-31)
Release notes

License: BSD

* Added setDebug() method and debugging capabilities
* added disconnect() method
* added sample file test_sieve.php
* fixed bug #591
* automagically selects the best auth method
0.8.1 (stable, 2002-07-27)
Release notes

License: BSD

Initial release
0.8 (stable, 2002-05-29)
Release notes

License: PHP

Initial release

Bugs

ID	Status	Type	Version	Date	Summary
#159	Closed	Bug		2003-10-27	Net_Sieve hangs when sasl doesn't report back plain as a login method
#591	Closed	Bug		2004-01-16	Net_Sieve doesn't handle 'bye'
#651	Closed	Bug		2004-01-31	Test depends on ./passwords.php
#1006	Closed	Bug		2004-03-13	Don't use Net_Socket::eof()
#1007	Bogus	Bug		2004-03-13	CVS out of sync
#2728	Closed	Bug		2004-11-10	Linebreaks not being read using getScript()
#2903	Closed	Bug		2004-12-05	Update CVS
#3242	Closed	Bug		2005-01-19	cyrus murder referrals not followed
#3519	Closed	Req		2005-02-18	Net_Sieve w/ externally established sockets
#4053	Closed	Req		2005-04-04	Please add start_tls support for sieve backend
#4794	Closed	Bug		2005-07-11	drops protocol prefix, e.g. "ssl://" in referrals
#6586	Closed	Req		2006-01-25	Where are the updates/developers
#7197	Closed	Bug	1.1.2	2006-03-24	getScript() truncates long scripts
#7845	Closed	Bug	1.1.3	2006-06-09	mbstring and other fixes
#8071	Closed	Req	1.1.4	2006-06-29	Disable tls if we don't want to use it
#8452	Closed	Bug	1.1.3	2006-08-16	Unterminated Read Loop
#8453	Closed	Req	CVS	2006-08-16	PHPDoc updates
#8782	Closed	Bug	1.1.4	2006-09-25	stream_context_create() expects parameter array
#9110	Closed	Bug	1.1.4	2006-10-20	connect problem
#9273	Closed	Bug	1.1.5	2006-11-08	_recvLn() hangs during CRAM-MD5 auth sequence
#9305	Closed	Bug	1.1.5	2006-11-11	TLS enabled if useTLS = false
#14205	Closed	Bug	1.1.6	2008-06-23	fetch the CAPABILITY string send after STARTTLS
#14335	Closed	Req	1.1.6	2008-07-12	extend constructor to accept options for connect()
#14336	Closed	Req	1.1.6	2008-07-12	add authentification mechanism EXTERNAL
#16647	Closed	Bug	CVS	2009-09-27	AUTHENTICATE command hangs
#16681	Closed	Req	1.1.7	2009-10-07	debug handler
#16691	Closed	Bug	1.2.0b1	2009-10-11	handling of non-safe characters in script names
#16820	Closed	Bug	1.1.7	2009-11-22	Use of PEAR methods without explicit import
#17038	Closed	Bug	CVS	2010-01-27	dl() throws E_ERROR
#17107	Closed	Bug	1.1.7	2010-02-16	can't follow referral -> empty Variables
#17285	Closed	Bug	SVN	2010-03-31	Bug in _authDigestMD5()
#17320	Closed	Bug	SVN	2010-04-19	Digest-MD5 Auth + Dovecot
#17489	Closed	Bug	1.2.2	2010-06-13	Tests don't pass
#17527	Closed	Bug	1.2.2	2010-06-28	LOGIN authentication doesn't work
#18228	Closed	Bug	SVN	2011-01-30	Improved string literals handling
#18241	Closed	Bug	SVN	2011-02-04	STARTTLS issue with timesieved 2.2
#18382	Closed	Req	1.3.0	2011-03-21	Polling for Capabilities
#18663	Closed	Bug	1.3.0	2011-07-13	Strict notice: PEAR::isError() should not be called statically
#18664	Bogus	Bug	1.3.0	2011-07-13	Strict notice: PEAR::isError() should not be called statically
#19077	Wont fix	Bug	1.3.2	2011-11-25	Problem when using DBMail-timsieved
#20490	Duplicate	Bug	1.3.3	2015-01-20	Redundant LISTSCRIPTS call
#20491	Closed	Req	1.3.4	2015-01-21	Redundant CAPABILITY requests
#20552	Wont fix	Bug	SVN	2015-05-29	PHP7 compatibility
#20983	Closed	Bug	1.3.4	2015-11-14	array_merge(): Argument #1 is not an array in /usr/share/pear/Net/Sieve.php 312
#21110	Wont fix	Bug	1.3.4	2016-09-08	Future PHP method compatibility