21568681844

Committed 01 Feb 2026 07:16PM UTC coverage: 85.41% (+1.0%) from 84.387%

Build # 21568681844

Build Type

push

github

Committed by

web-flow

Commit Message

Merge pull request #9916 from codeigniter4/4.7

4.7.0 Merge code

Run Details

1603 of 1888 new or added lines in 101 files covered. (84.9%)

31 existing lines in 11 files now uncovered.

22163 of 25949 relevant lines covered (85.41%)

205.52 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

76.09

/system/Encryption/Handlers/SodiumHandler.php

<?php

declare(strict_types=1);

/**
 * This file is part of CodeIgniter 4 framework.
 *
 * (c) CodeIgniter Foundation <admin@codeigniter.com>
 *
 * For the full copyright and license information, please view
 * the LICENSE file that was distributed with this source code.
 */

namespace CodeIgniter\Encryption\Handlers;

use CodeIgniter\Encryption\Exceptions\EncryptionException;
use SensitiveParameter;

/**
 * SodiumHandler uses libsodium in encryption.
 *
 * @see https://github.com/jedisct1/libsodium/issues/392
 * @see \CodeIgniter\Encryption\Handlers\SodiumHandlerTest
 */
class SodiumHandler extends BaseHandler
{
    /**
     * Starter key
     *
     * @var string|null Null is used for buffer cleanup.
     */
    protected $key = '';

    /**
     * Block size for padding message.
     *
     * @var int
     */
    protected $blockSize = 16;

    /**
     * {@inheritDoc}
     */
    public function encrypt(#[SensitiveParameter] $data, #[SensitiveParameter] $params = null)
    {
        // Allow key override
        $key = $params !== null
            ? (is_array($params) && isset($params['key']) ? $params['key'] : $params)
            : $this->key;

        // Allow blockSize override
        $blockSize = (is_array($params) && isset($params['blockSize']))
            ? $params['blockSize']
            : $this->blockSize;

        if (empty($key)) {
            throw EncryptionException::forNeedsStarterKey();
        }

        // create a nonce for this operation
        $nonce = random_bytes(SODIUM_CRYPTO_SECRETBOX_NONCEBYTES); // 24 bytes

        // add padding before we encrypt the data
        if ($blockSize <= 0) {
            throw EncryptionException::forEncryptionFailed();
        }

        $data = sodium_pad($data, $blockSize);

        // encrypt message and combine with nonce
        $ciphertext = $nonce . sodium_crypto_secretbox($data, $nonce, $key);

        // cleanup buffers
        sodium_memzero($data);
        sodium_memzero($key);

        return $ciphertext;
    }

    /**
     * {@inheritDoc}
     */
    public function decrypt($data, #[SensitiveParameter] $params = null)
    {
        // Allow key override
        $key = $params !== null
            ? (is_array($params) && isset($params['key']) ? $params['key'] : $params)
            : $this->key;

        // Allow blockSize override
        $blockSize = (is_array($params) && isset($params['blockSize']))
            ? $params['blockSize']
            : $this->blockSize;

        if (empty($key)) {
            throw EncryptionException::forNeedsStarterKey();
        }

        if (mb_strlen($data, '8bit') < (SODIUM_CRYPTO_SECRETBOX_NONCEBYTES + SODIUM_CRYPTO_SECRETBOX_MACBYTES)) {
            // message was truncated
            throw EncryptionException::forAuthenticationFailed();
        }

        // Extract info from encrypted data
        $nonce      = self::substr($data, 0, SODIUM_CRYPTO_SECRETBOX_NONCEBYTES);
        $ciphertext = self::substr($data, SODIUM_CRYPTO_SECRETBOX_NONCEBYTES);

        // decrypt data
        $data = sodium_crypto_secretbox_open($ciphertext, $nonce, $key);

        if ($data === false) {
            // message was tampered in transit
            throw EncryptionException::forAuthenticationFailed(); // @codeCoverageIgnore
        }

        // remove extra padding during encryption
        if ($blockSize <= 0) {
            throw EncryptionException::forAuthenticationFailed();
        }

        $data = sodium_unpad($data, $blockSize);

        // cleanup buffers
        sodium_memzero($ciphertext);
        sodium_memzero($key);

        return $data;
    }

    /**
     * Parse the $params before doing assignment.
     *
     * @param array|string|null $params
     *
     * @return void
     *
     * @throws EncryptionException If key is empty
     *
     * @deprecated 4.7.0 No longer used.
     */
    protected function parseParams($params)
    {
        if ($params === null) {
            return;
        }

        if (is_array($params)) {
            if (isset($params['key'])) {
                $this->key = $params['key'];
            }

            if (isset($params['blockSize'])) {
                $this->blockSize = $params['blockSize'];
            }

            return;
        }

        $this->key = (string) $params;
    }
}

1	<?php
2
3	declare(strict_types=1);
4
5	/**
6	* This file is part of CodeIgniter 4 framework.
7	*
8	* (c) CodeIgniter Foundation <admin@codeigniter.com>
9	*
10	* For the full copyright and license information, please view
11	* the LICENSE file that was distributed with this source code.
12	*/
13
14	namespace CodeIgniter\Encryption\Handlers;
15
16	use CodeIgniter\Encryption\Exceptions\EncryptionException;
17	use SensitiveParameter;
18
19	/**
20	* SodiumHandler uses libsodium in encryption.
21	*
22	* @see https://github.com/jedisct1/libsodium/issues/392
23	* @see \CodeIgniter\Encryption\Handlers\SodiumHandlerTest
24	*/
25	class SodiumHandler extends BaseHandler
26	{
27	/**
28	* Starter key
29	*
30	* @var string\|null Null is used for buffer cleanup.
31	*/
32	protected $key = '';
33
34	/**
35	* Block size for padding message.
36	*
37	* @var int
38	*/
39	protected $blockSize = 16;
40
41	/**
42	* {@inheritDoc}
43	*/
44	public function encrypt(#[SensitiveParameter] $data, #[SensitiveParameter] $params = null)
45	{
46	// Allow key override
47	$key = $params !== null	8✔
48	? (is_array($params) && isset($params['key']) ? $params['key'] : $params)	2✔
49	: $this->key;	7✔
50
51	// Allow blockSize override
52	$blockSize = (is_array($params) && isset($params['blockSize']))	8✔
NEW 53	? $params['blockSize']	×
54	: $this->blockSize;	8✔
55
56	if (empty($key)) {	8✔
57	throw EncryptionException::forNeedsStarterKey();	1✔
58	}
59
60	// create a nonce for this operation
61	$nonce = random_bytes(SODIUM_CRYPTO_SECRETBOX_NONCEBYTES); // 24 bytes	7✔
62
63	// add padding before we encrypt the data
64	if ($blockSize <= 0) {	7✔
65	throw EncryptionException::forEncryptionFailed();	1✔
66	}
67
68	$data = sodium_pad($data, $blockSize);	6✔
69
70	// encrypt message and combine with nonce
71	$ciphertext = $nonce . sodium_crypto_secretbox($data, $nonce, $key);	6✔
72
73	// cleanup buffers
74	sodium_memzero($data);	6✔
75	sodium_memzero($key);	6✔
76
77	return $ciphertext;	6✔
78	}
79
80	/**
81	* {@inheritDoc}
82	*/
83	public function decrypt($data, #[SensitiveParameter] $params = null)
84	{
85	// Allow key override
86	$key = $params !== null	6✔
87	? (is_array($params) && isset($params['key']) ? $params['key'] : $params)	5✔
88	: $this->key;	2✔
89
90	// Allow blockSize override
91	$blockSize = (is_array($params) && isset($params['blockSize']))	6✔
92	? $params['blockSize']	2✔
93	: $this->blockSize;	4✔
94
95	if (empty($key)) {	6✔
UNCOV 96	throw EncryptionException::forNeedsStarterKey();	×
97	}
98
99	if (mb_strlen($data, '8bit') < (SODIUM_CRYPTO_SECRETBOX_NONCEBYTES + SODIUM_CRYPTO_SECRETBOX_MACBYTES)) {	6✔
100	// message was truncated
101	throw EncryptionException::forAuthenticationFailed();	1✔
102	}
103
104	// Extract info from encrypted data
105	$nonce = self::substr($data, 0, SODIUM_CRYPTO_SECRETBOX_NONCEBYTES);	5✔
106	$ciphertext = self::substr($data, SODIUM_CRYPTO_SECRETBOX_NONCEBYTES);	5✔
107
108	// decrypt data
109	$data = sodium_crypto_secretbox_open($ciphertext, $nonce, $key);	5✔
110
111	if ($data === false) {	5✔
112	// message was tampered in transit
113	throw EncryptionException::forAuthenticationFailed(); // @codeCoverageIgnore	1✔
114	}
115
116	// remove extra padding during encryption
117	if ($blockSize <= 0) {	5✔
118	throw EncryptionException::forAuthenticationFailed();	1✔
119	}
120
121	$data = sodium_unpad($data, $blockSize);	4✔
122
123	// cleanup buffers
124	sodium_memzero($ciphertext);	4✔
125	sodium_memzero($key);	4✔
126
127	return $data;	4✔
128	}
129
130	/**
131	* Parse the $params before doing assignment.
132	*
133	* @param array\|string\|null $params
134	*
135	* @return void
136	*
137	* @throws EncryptionException If key is empty
138	*
139	* @deprecated 4.7.0 No longer used.
140	*/
141	protected function parseParams($params)
142	{
UNCOV 143	if ($params === null) {	×
UNCOV 144	return;	×
145	}
146
UNCOV 147	if (is_array($params)) {	×
UNCOV 148	if (isset($params['key'])) {	×
UNCOV 149	$this->key = $params['key'];	×
150	}
151
UNCOV 152	if (isset($params['blockSize'])) {	×
UNCOV 153	$this->blockSize = $params['blockSize'];	×
154	}
155
UNCOV 156	return;	×
157	}
158
UNCOV 159	$this->key = (string) $params;	×
160	}
161	}

codeigniter4 / CodeIgniter4 / 21568681844

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous