reference/openssl/constants.xml
5380fa1f30a0beacd62aec0d331939015f395fd6
...
...
@@ -9,7 +9,7 @@
9
9
<varlistentry xml:id="constant.x509-purpose-ssl-client">
10
10
<term>
11
11
<constant>X509_PURPOSE_SSL_CLIENT</constant>
12
-
(<type>integer</type>)
12
+
(<type>int</type>)
13
13
</term>
14
14
<listitem>
15
15
<simpara>
...
...
@@ -20,7 +20,7 @@
20
20
<varlistentry xml:id="constant.x509-purpose-ssl-server">
21
21
<term>
22
22
<constant>X509_PURPOSE_SSL_SERVER</constant>
23
-
(<type>integer</type>)
23
+
(<type>int</type>)
24
24
</term>
25
25
<listitem>
26
26
<simpara>
...
...
@@ -31,7 +31,7 @@
31
31
<varlistentry xml:id="constant.x509-purpose-ns-ssl-server">
32
32
<term>
33
33
<constant>X509_PURPOSE_NS_SSL_SERVER</constant>
34
-
(<type>integer</type>)
34
+
(<type>int</type>)
35
35
</term>
36
36
<listitem>
37
37
<simpara>
...
...
@@ -42,7 +42,7 @@
42
42
<varlistentry xml:id="constant.x509-purpose-smime-sign">
43
43
<term>
44
44
<constant>X509_PURPOSE_SMIME_SIGN</constant>
45
-
(<type>integer</type>)
45
+
(<type>int</type>)
46
46
</term>
47
47
<listitem>
48
48
<simpara>
...
...
@@ -53,7 +53,7 @@
53
53
<varlistentry xml:id="constant.x509-purpose-smime-encrypt">
54
54
<term>
55
55
<constant>X509_PURPOSE_SMIME_ENCRYPT</constant>
56
-
(<type>integer</type>)
56
+
(<type>int</type>)
57
57
</term>
58
58
<listitem>
59
59
<simpara>
...
...
@@ -64,7 +64,7 @@
64
64
<varlistentry xml:id="constant.x509-purpose-crl-sign">
65
65
<term>
66
66
<constant>X509_PURPOSE_CRL_SIGN</constant>
67
-
(<type>integer</type>)
67
+
(<type>int</type>)
68
68
</term>
69
69
<listitem>
70
70
<simpara>
...
...
@@ -75,7 +75,7 @@
75
75
<varlistentry xml:id="constant.x509-purpose-any">
76
76
<term>
77
77
<constant>X509_PURPOSE_ANY</constant>
78
-
(<type>integer</type>)
78
+
(<type>int</type>)
79
79
</term>
80
80
<listitem>
81
81
<simpara>
...
...
@@ -92,7 +92,7 @@
92
92
<varlistentry xml:id="constant.openssl-pkcs1-padding">
93
93
<term>
94
94
<constant>OPENSSL_PKCS1_PADDING</constant>
95
-
(<type>integer</type>)
95
+
(<type>int</type>)
96
96
</term>
97
97
<listitem>
98
98
<simpara>
...
...
@@ -103,7 +103,7 @@
103
103
<varlistentry xml:id="constant.openssl-sslv23-padding">
104
104
<term>
105
105
<constant>OPENSSL_SSLV23_PADDING</constant>
106
-
(<type>integer</type>)
106
+
(<type>int</type>)
107
107
</term>
108
108
<listitem>
109
109
<simpara>
...
...
@@ -114,7 +114,7 @@
114
114
<varlistentry xml:id="constant.openssl-no-padding">
115
115
<term>
116
116
<constant>OPENSSL_NO_PADDING</constant>
117
-
(<type>integer</type>)
117
+
(<type>int</type>)
118
118
</term>
119
119
<listitem>
120
120
<simpara>
...
...
@@ -125,7 +125,7 @@
125
125
<varlistentry xml:id="constant.openssl-pkcs1-oaep-padding">
126
126
<term>
127
127
<constant>OPENSSL_PKCS1_OAEP_PADDING</constant>
128
-
(<type>integer</type>)
128
+
(<type>int</type>)
129
129
</term>
130
130
<listitem>
131
131
<simpara>
...
...
@@ -142,7 +142,7 @@
142
142
<varlistentry xml:id="constant.openssl-keytype-rsa">
143
143
<term>
144
144
<constant>OPENSSL_KEYTYPE_RSA</constant>
145
-
(<type>integer</type>)
145
+
(<type>int</type>)
146
146
</term>
147
147
<listitem>
148
148
<simpara>
...
...
@@ -153,7 +153,7 @@
153
153
<varlistentry xml:id="constant.openssl-keytype-dsa">
154
154
<term>
155
155
<constant>OPENSSL_KEYTYPE_DSA</constant>
156
-
(<type>integer</type>)
156
+
(<type>int</type>)
157
157
</term>
158
158
<listitem>
159
159
<simpara>
...
...
@@ -164,7 +164,7 @@
164
164
<varlistentry xml:id="constant.openssl-keytype-dh">
165
165
<term>
166
166
<constant>OPENSSL_KEYTYPE_DH</constant>
167
-
(<type>integer</type>)
167
+
(<type>int</type>)
168
168
</term>
169
169
<listitem>
170
170
<simpara>
...
...
@@ -175,7 +175,7 @@
175
175
<varlistentry xml:id="constant.openssl-keytype-ec">
176
176
<term>
177
177
<constant>OPENSSL_KEYTYPE_EC</constant>
178
-
(<type>integer</type>)
178
+
(<type>int</type>)
179
179
</term>
180
180
<listitem>
181
181
<simpara>
...
...
@@ -184,12 +184,6 @@
184
184
</listitem>
185
185
</varlistentry>
186
186
</variablelist>
187
-
<note>
188
-
<para>This constant was added in 5.2.0.</para>
189
-
<para>
190
-
<constant>OPENSSL_KEYTYPE_EC</constant>
191
-
</para>
192
-
</note>
193
187
</section>
194
188

195
189
<section xml:id="openssl.pkcs7.flags">
...
...
@@ -208,14 +202,20 @@
208
202
</thead>
209
203
<tbody>
210
204
<row xml:id="constant.pkcs7-text">
211
-
<entry><constant>PKCS7_TEXT</constant></entry>
205
+
<entry>
206
+
<constant>PKCS7_TEXT</constant>
207
+
(<type>int</type>)
208
+
</entry>
212
209
<entry>Adds text/plain content type headers to encrypted/signed
213
210
message. If decrypting or verifying, it strips those headers from
214
211
the output - if the decrypted or verified message is not of MIME type
215
212
text/plain then an error will occur.</entry>
216
213
</row>
217
214
<row xml:id="constant.pkcs7-binary">
218
-
<entry><constant>PKCS7_BINARY</constant></entry>
215
+
<entry>
216
+
<constant>PKCS7_BINARY</constant>
217
+
(<type>int</type>)
218
+
</entry>
219
219
<entry>Normally the input message is converted to "canonical" format
220
220
which is effectively using <literal>CR</literal> and <literal>LF</literal>
221
221
as end of line: as required by the S/MIME specification. When this
...
...
@@ -223,46 +223,64 @@
223
223
handling binary data which may not be in MIME format.</entry>
224
224
</row>
225
225
<row xml:id="constant.pkcs7-nointern">
226
-
<entry><constant>PKCS7_NOINTERN</constant></entry>
226
+
<entry>
227
+
<constant>PKCS7_NOINTERN</constant>
228
+
(<type>int</type>)
229
+
</entry>
227
230
<entry>When verifying a message, certificates (if
228
231
any) included in the message are normally searched for the
229
232
signing certificate. With this option only the
230
-
certificates specified in the <parameter>extracerts</parameter>
233
+
certificates specified in the <parameter>untrusted_certificates_filename</parameter>
231
234
parameter of <function>openssl_pkcs7_verify</function> are
232
235
used. The supplied certificates can still be used as
233
236
untrusted CAs however.
234
237
</entry>
235
238
</row>
236
239
<row xml:id="constant.pkcs7-noverify">
237
-
<entry><constant>PKCS7_NOVERIFY</constant></entry>
240
+
<entry>
241
+
<constant>PKCS7_NOVERIFY</constant>
242
+
(<type>int</type>)
243
+
</entry>
238
244
<entry>Do not verify the signers certificate of a signed
239
245
message.</entry>
240
246
</row>
241
247
<row xml:id="constant.pkcs7-nochain">
242
-
<entry><constant>PKCS7_NOCHAIN</constant></entry>
248
+
<entry>
249
+
<constant>PKCS7_NOCHAIN</constant>
250
+
(<type>int</type>)
251
+
</entry>
243
252
<entry>Do not chain verification of signers certificates: that is
244
253
don't use the certificates in the signed message as untrusted CAs.
245
254
</entry>
246
255
</row>
247
256
<row xml:id="constant.pkcs7-nocerts">
248
-
<entry><constant>PKCS7_NOCERTS</constant></entry>
257
+
<entry>
258
+
<constant>PKCS7_NOCERTS</constant>
259
+
(<type>int</type>)
260
+
</entry>
249
261
<entry>When signing a message the signer's certificate is normally
250
262
included - with this option it is excluded. This will reduce the
251
263
size of the signed message but the verifier must have a copy of the
252
264
signers certificate available locally (passed using the
253
-
<parameter>extracerts</parameter> to
265
+
<parameter>untrusted_certificates_filename</parameter> to
254
266
<function>openssl_pkcs7_verify</function> for example).
255
267
</entry>
256
268
</row>
257
269
<row xml:id="constant.pkcs7-noattr">
258
-
<entry><constant>PKCS7_NOATTR</constant></entry>
270
+
<entry>
271
+
<constant>PKCS7_NOATTR</constant>
272
+
(<type>int</type>)
273
+
</entry>
259
274
<entry>Normally when a message is signed, a set of attributes are
260
275
included which include the signing time and the supported symmetric
261
276
algorithms. With this option they are not included.
262
277
</entry>
263
278
</row>
264
279
<row xml:id="constant.pkcs7-detached">
265
-
<entry><constant>PKCS7_DETACHED</constant></entry>
280
+
<entry>
281
+
<constant>PKCS7_DETACHED</constant>
282
+
(<type>int</type>)
283
+
</entry>
266
284
<entry>When signing a message, use cleartext signing with the MIME
267
285
type <literal>"multipart/signed"</literal>. This is the default
268
286
if you do not specify any <parameter>flags</parameter> to
...
...
@@ -272,16 +290,156 @@
272
290
but cannot be read by mail agents that do not support S/MIME.</entry>
273
291
</row>
274
292
<row xml:id="constant.pkcs7-nosigs">
275
-
<entry><constant>PKCS7_NOSIGS</constant></entry>
293
+
<entry>
294
+
<constant>PKCS7_NOSIGS</constant>
295
+
(<type>int</type>)
296
+
</entry>
297
+
<entry>Don't try and verify the signatures on a message</entry>
298
+
</row>
299
+
<row xml:id="constant.pkcs7-nooldmimetype">
300
+
<entry>
301
+
<constant>PKCS7_NOOLDMIMETYPE</constant>
302
+
(<type>int</type>)
303
+
</entry>
304
+
<entry>
305
+
Available as of PHP 8.3.0.
306
+
Sets the content-type to <literal>application/pkcs7-mime</literal> instead of
307
+
<literal>application/x-pkcs7-mime</literal> to encrypt a message.
308
+
</entry>
309
+
</row>
310
+
</tbody>
311
+
</tgroup>
312
+
</table>
313
+
</para>
314
+
</section>
315
+

316
+
<section xml:id="openssl.cms.flags">
317
+
<title><acronym>CMS</acronym> Flags/Constants</title>
318
+
<para>
319
+
The CMS functions make use of flags which are specified using a
320
+
bitfield which can include one or more of the following values:
321
+
<table>
322
+
<title><acronym>CMS</acronym> CONSTANTS</title>
323
+
<tgroup cols="2">
324
+
<thead>
325
+
<row>
326
+
<entry>Constant</entry>
327
+
<entry>Description</entry>
328
+
</row>
329
+
</thead>
330
+
<tbody>
331
+
<row xml:id="constant.openssl-cms-text">
332
+
<entry>
333
+
<constant>OPENSSL_CMS_TEXT</constant>
334
+
(<type>int</type>)
335
+
</entry>
336
+
<entry>
337
+
Adds text/plain content type headers to encrypted/signed
338
+
message. If decrypting or verifying, it strips those headers from
339
+
the output - if the decrypted or verified message is not of MIME type
340
+
text/plain then an error will occur.
341
+
</entry>
342
+
</row>
343
+
<row xml:id="constant.openssl-cms-binary">
344
+
<entry>
345
+
<constant>OPENSSL_CMS_BINARY</constant>
346
+
(<type>int</type>)
347
+
</entry>
348
+
<entry>
349
+
Normally the input message is converted to "canonical" format
350
+
which is effectively using <literal>CR</literal> and <literal>LF</literal>
351
+
as end of line: as required by the CMS specification. When this
352
+
option is present, no translation occurs. This is useful when
353
+
handling binary data which may not be in CMS format.
354
+
</entry>
355
+
</row>
356
+
<row xml:id="constant.openssl-cms-nointern">
357
+
<entry>
358
+
<constant>OPENSSL_CMS_NOINTERN</constant>
359
+
(<type>int</type>)
360
+
</entry>
361
+
<entry>
362
+
When verifying a message, certificates (if
363
+
any) included in the message are normally searched for the
364
+
signing certificate. With this option only the
365
+
certificates specified in the <parameter>untrusted_certificates_filename</parameter>
366
+
parameter of <function>openssl_cms_verify</function> are
367
+
used. The supplied certificates can still be used as
368
+
untrusted CAs however.
369
+
</entry>
370
+
</row>
371
+
<row xml:id="constant.openssl-cms-noverify">
372
+
<entry>
373
+
<constant>OPENSSL_CMS_NOVERIFY</constant>
374
+
(<type>int</type>)
375
+
</entry>
376
+
<entry>
377
+
Do not verify the signers certificate of a signed
378
+
message.
379
+
</entry>
380
+
</row>
381
+
<row xml:id="constant.openssl-cms-nocerts">
382
+
<entry>
383
+
<constant>OPENSSL_CMS_NOCERTS</constant>
384
+
(<type>int</type>)
385
+
</entry>
386
+
<entry>
387
+
When signing a message the signer's certificate is normally
388
+
included - with this option it is excluded. This will reduce the
389
+
size of the signed message but the verifier must have a copy of the
390
+
signers certificate available locally (passed using the
391
+
<parameter>untrusted_certificates_filename</parameter> to
392
+
<function>openssl_cms_verify</function> for example).
393
+
</entry>
394
+
</row>
395
+
<row xml:id="constant.openssl-cms-noattr">
396
+
<entry>
397
+
<constant>OPENSSL_CMS_NOATTR</constant>
398
+
(<type>int</type>)
399
+
</entry>
400
+
<entry>
401
+
Normally when a message is signed, a set of attributes are
402
+
included which include the signing time and the supported symmetric
403
+
algorithms. With this option they are not included.
404
+
</entry>
405
+
</row>
406
+
<row xml:id="constant.openssl-cms-detached">
407
+
<entry>
408
+
<constant>OPENSSL_CMS_DETACHED</constant>
409
+
(<type>int</type>)
410
+
</entry>
411
+
<entry>
412
+
When signing a message, use cleartext signing with the MIME
413
+
type <literal>"multipart/signed"</literal>. This is the default
414
+
if you do not specify any <parameter>flags</parameter> to
415
+
<function>openssl_cms_sign</function>.
416
+
If you turn this option off, the message will be signed using
417
+
opaque signing, which is more resistant to translation by mail relays
418
+
but cannot be read by mail agents that do not support S/MIME.
419
+
</entry>
420
+
</row>
421
+
<row xml:id="constant.openssl-cms-nosigs">
422
+
<entry>
423
+
<constant>OPENSSL_CMS_NOSIGS</constant>
424
+
(<type>int</type>)
425
+
</entry>
276
426
<entry>Don't try and verify the signatures on a message</entry>
277
427
</row>
428
+
<row xml:id="constant.openssl-cms-oldmimetype">
429
+
<entry>
430
+
<constant>OPENSSL_CMS_OLDMIMETYPE</constant>
431
+
(<type>int</type>)
432
+
</entry>
433
+
<entry>
434
+
Available as of PHP 8.3.0.
435
+
Sets the content-type to <literal>application/x-pkcs7-mime</literal> instead of
436
+
<literal>application/pkcs7-mime</literal> to encrypt a message.
437
+
</entry>
438
+
</row>
278
439
</tbody>
279
440
</tgroup>
280
441
</table>
281
442
</para>
282
-
<note>
283
-
<para>These constants were added in 4.0.6.</para>
284
-
</note>
285
443
</section>
286
444

287
445
<section xml:id="openssl.signature-algos">
...
...
@@ -290,7 +448,7 @@
290
448
<varlistentry xml:id="constant.openssl-algo-dss1">
291
449
<term>
292
450
<constant>OPENSSL_ALGO_DSS1</constant>
293
-
(<type>integer</type>)
451
+
(<type>int</type>)
294
452
</term>
295
453
<listitem>
296
454
<simpara>
...
...
@@ -301,7 +459,7 @@
301
459
<varlistentry xml:id="constant.openssl-algo-sha1">
302
460
<term>
303
461
<constant>OPENSSL_ALGO_SHA1</constant>
304
-
(<type>integer</type>)
462
+
(<type>int</type>)
305
463
</term>
306
464
<listitem>
307
465
<simpara>
...
...
@@ -313,7 +471,7 @@
313
471
<varlistentry xml:id="constant.openssl-algo-sha224">
314
472
<term>
315
473
<constant>OPENSSL_ALGO_SHA224</constant>
316
-
(<type>integer</type>)
474
+
(<type>int</type>)
317
475
</term>
318
476
<listitem>
319
477
<simpara>
...
...
@@ -324,7 +482,7 @@
324
482
<varlistentry xml:id="constant.openssl-algo-sha256">
325
483
<term>
326
484
<constant>OPENSSL_ALGO_SHA256</constant>
327
-
(<type>integer</type>)
485
+
(<type>int</type>)
328
486
</term>
329
487
<listitem>
330
488
<simpara>
...
...
@@ -335,7 +493,7 @@
335
493
<varlistentry xml:id="constant.openssl-algo-sha384">
336
494
<term>
337
495
<constant>OPENSSL_ALGO_SHA384</constant>
338
-
(<type>integer</type>)
496
+
(<type>int</type>)
339
497
</term>
340
498
<listitem>
341
499
<simpara>
...
...
@@ -346,7 +504,7 @@
346
504
<varlistentry xml:id="constant.openssl-algo-sha512">
347
505
<term>
348
506
<constant>OPENSSL_ALGO_SHA512</constant>
349
-
(<type>integer</type>)
507
+
(<type>int</type>)
350
508
</term>
351
509
<listitem>
352
510
<simpara>
...
...
@@ -357,7 +515,7 @@
357
515
<varlistentry xml:id="constant.openssl-algo-rmd160">
358
516
<term>
359
517
<constant>OPENSSL_ALGO_RMD160</constant>
360
-
(<type>integer</type>)
518
+
(<type>int</type>)
361
519
</term>
362
520
<listitem>
363
521
<simpara>
...
...
@@ -368,7 +526,7 @@
368
526
<varlistentry xml:id="constant.openssl-algo-md5">
369
527
<term>
370
528
<constant>OPENSSL_ALGO_MD5</constant>
371
-
(<type>integer</type>)
529
+
(<type>int</type>)
372
530
</term>
373
531
<listitem>
374
532
<simpara>
...
...
@@ -379,7 +537,7 @@
379
537
<varlistentry xml:id="constant.openssl-algo-md4">
380
538
<term>
381
539
<constant>OPENSSL_ALGO_MD4</constant>
382
-
(<type>integer</type>)
540
+
(<type>int</type>)
383
541
</term>
384
542
<listitem>
385
543
<simpara>
...
...
@@ -390,11 +548,11 @@
390
548
<varlistentry xml:id="constant.openssl-algo-md2">
391
549
<term>
392
550
<constant>OPENSSL_ALGO_MD2</constant>
393
-
(<type>integer</type>)
551
+
(<type>int</type>)
394
552
</term>
395
553
<listitem>
396
554
<simpara>
397
-
As of PHP 5.2.13 and PHP 5.3.2, this constant is only available
555
+
This constant is only available
398
556
if PHP is compiled with MD2 support. This requires passing in the
399
557
-DHAVE_OPENSSL_MD2_H CFLAG when compiling PHP, and enable-md2 when
400
558
compiling OpenSSL 1.0.0+.
...
...
@@ -403,23 +561,6 @@
403
561
</varlistentry>
404
562
</variablelist>
405
563

406
-
<note>
407
-
<para>These constants were added in 5.0.0.</para>
408
-
<para>
409
-
<constant>OPENSSL_ALGO_MD2</constant>, <constant>OPENSSL_ALGO_MD4</constant>,
410
-
<constant>OPENSSL_ALGO_MD5</constant>, <constant>OPENSSL_ALGO_SHA1</constant>,
411
-
<constant>OPENSSL_ALGO_DSS1</constant>
412
-
</para>
413
-
</note>
414
-
<note>
415
-
<para>These constants were added in 5.4.8.</para>
416
-
<para>
417
-
<constant>OPENSSL_ALGO_RMD160</constant>, <constant>OPENSSL_ALGO_SHA224</constant>,
418
-
<constant>OPENSSL_ALGO_SHA256</constant>, <constant>OPENSSL_ALGO_SHA384</constant>,
419
-
<constant>OPENSSL_ALGO_SHA512</constant>
420
-
</para>
421
-
</note>
422
-

423
564
</section>
424
565

425
566
<section xml:id="openssl.ciphers">
...
...
@@ -428,7 +569,7 @@
428
569
<varlistentry xml:id="constant.openssl-cipher-rc2-40">
429
570
<term>
430
571
<constant>OPENSSL_CIPHER_RC2_40</constant>
431
-
(<type>integer</type>)
572
+
(<type>int</type>)
432
573
</term>
433
574
<listitem>
434
575
<simpara>
...
...
@@ -439,7 +580,7 @@
439
580
<varlistentry xml:id="constant.openssl-cipher-rc2-128">
440
581
<term>
441
582
<constant>OPENSSL_CIPHER_RC2_128</constant>
442
-
(<type>integer</type>)
583
+
(<type>int</type>)
443
584
</term>
444
585
<listitem>
445
586
<simpara>
...
...
@@ -450,7 +591,7 @@
450
591
<varlistentry xml:id="constant.openssl-cipher-rc2-64">
451
592
<term>
452
593
<constant>OPENSSL_CIPHER_RC2_64</constant>
453
-
(<type>integer</type>)
594
+
(<type>int</type>)
454
595
</term>
455
596
<listitem>
456
597
<simpara>
...
...
@@ -461,7 +602,7 @@
461
602
<varlistentry xml:id="constant.openssl-cipher-des">
462
603
<term>
463
604
<constant>OPENSSL_CIPHER_DES</constant>
464
-
(<type>integer</type>)
605
+
(<type>int</type>)
465
606
</term>
466
607
<listitem>
467
608
<simpara>
...
...
@@ -472,7 +613,7 @@
472
613
<varlistentry xml:id="constant.openssl-cipher-3des">
473
614
<term>
474
615
<constant>OPENSSL_CIPHER_3DES</constant>
475
-
(<type>integer</type>)
616
+
(<type>int</type>)
476
617
</term>
477
618
<listitem>
478
619
<simpara>
...
...
@@ -481,14 +622,11 @@
481
622
</listitem>
482
623
</varlistentry>
483
624
</variablelist>
484
-
<note>
485
-
<para>These constants were added in 4.3.0.</para>
486
-
</note>
487
-
<variablelist>
625
+
<variablelist>
488
626
<varlistentry xml:id="constant.openssl-cipher-aes-128-cbc">
489
627
<term>
490
628
<constant>OPENSSL_CIPHER_AES_128_CBC</constant>
491
-
(<type>integer</type>)
629
+
(<type>int</type>)
492
630
</term>
493
631
<listitem>
494
632
<simpara>
...
...
@@ -499,7 +637,7 @@
499
637
<varlistentry xml:id="constant.openssl-cipher-aes-192-cbc">
500
638
<term>
501
639
<constant>OPENSSL_CIPHER_AES_192_CBC</constant>
502
-
(<type>integer</type>)
640
+
(<type>int</type>)
503
641
</term>
504
642
<listitem>
505
643
<simpara>
...
...
@@ -510,7 +648,7 @@
510
648
<varlistentry xml:id="constant.openssl-cipher-aes-256-cbc">
511
649
<term>
512
650
<constant>OPENSSL_CIPHER_AES_256_CBC</constant>
513
-
(<type>integer</type>)
651
+
(<type>int</type>)
514
652
</term>
515
653
<listitem>
516
654
<simpara>
...
...
@@ -519,18 +657,15 @@
519
657
</listitem>
520
658
</varlistentry>
521
659
</variablelist>
522
-
<note>
523
-
<para>These constants were added in 5.4.0.</para>
524
-
</note>
525
-
</section>
660
+
</section>
526
661

527
662
<section xml:id="openssl.constversion">
528
663
<title>Version constants</title>
529
664
<variablelist>
530
665
<varlistentry xml:id="constant.openssl-version-text">
531
666
<term>
532
-
<constant>OPENSSL_VERSION_TEXT</constant>
533
-
(<type>string</type>)
667
+
<constant>OPENSSL_VERSION_TEXT</constant>
668
+
(<type>string</type>)
534
669
</term>
535
670
<listitem>
536
671
<simpara>
...
...
@@ -540,8 +675,8 @@
540
675
</varlistentry>
541
676
<varlistentry xml:id="constant.openssl-version-number">
542
677
<term>
543
-
<constant>OPENSSL_VERSION_NUMBER</constant>
544
-
(<type>integer</type>)
678
+
<constant>OPENSSL_VERSION_NUMBER</constant>
679
+
(<type>int</type>)
545
680
</term>
546
681
<listitem>
547
682
<simpara>
...
...
@@ -550,9 +685,6 @@
550
685
</listitem>
551
686
</varlistentry>
552
687
</variablelist>
553
-
<note>
554
-
<para>These constants were added in 5.2.0.</para>
555
-
</note>
556
688
</section>
557
689

558
690
<section xml:id="openssl.constsni">
...
...
@@ -560,8 +692,8 @@
560
692
<variablelist>
561
693
<varlistentry xml:id="constant.openssl-tlsext-server-name">
562
694
<term>
563
-
<constant>OPENSSL_TLSEXT_SERVER_NAME</constant>
564
-
(<type>string</type>)
695
+
<constant>OPENSSL_TLSEXT_SERVER_NAME</constant>
696
+
(<type>int</type>)
565
697
</term>
566
698
<listitem>
567
699
<simpara>
...
...
@@ -572,14 +704,82 @@
572
704
</variablelist>
573
705
<note>
574
706
<para>
575
-
This constant were added in 5.3.2 and requires PHP to be
707
+
This constant requires PHP to be
576
708
built with OpenSSL 0.9.8j or greater.
577
709
</para>
578
710
</note>
579
711
</section>
580
712

713
+
<section xml:id="openssl.constants.other">
714
+
<title>Other Constants</title>
715
+
<variablelist>
716
+
<varlistentry xml:id="constant.openssl-raw-data">
717
+
<term>
718
+
<constant>OPENSSL_RAW_DATA</constant>
719
+
(<type>int</type>)
720
+
</term>
721
+
<listitem>
722
+
<simpara>
723
+
If <constant>OPENSSL_RAW_DATA</constant> is set in the
724
+
<function>openssl_encrypt</function> or <function>openssl_decrypt</function>,
725
+
the returned data is returned as-is.
726
+
When it is not specified, Base64 encoded data is returned to the caller.
727
+
</simpara>
728
+
</listitem>
729
+
</varlistentry>
730
+
<varlistentry xml:id="constant.openssl-zero-padding">
731
+
<term>
732
+
<constant>OPENSSL_ZERO_PADDING</constant>
733
+
(<type>int</type>)
734
+
</term>
735
+
<listitem>
736
+
<simpara>
737
+
By default encryption operations are padded using standard block
738
+
padding and the padding is checked and removed when decrypting.
739
+
If <constant>OPENSSL_ZERO_PADDING</constant> is set in the
740
+
<function>openssl_encrypt</function> or <function>openssl_decrypt</function>
741
+
<parameter>options</parameter> then no padding is performed, the total
742
+
amount of data encrypted or decrypted must then be a multiple of the
743
+
block size or an error will occur.
744
+
</simpara>
745
+
</listitem>
746
+
</varlistentry>
747
+
<varlistentry xml:id="constant.openssl-encoding-smime">
748
+
<term>
749
+
<constant>OPENSSL_ENCODING_SMIME</constant>
750
+
(<type>int</type>)
751
+
</term>
752
+
<listitem>
753
+
<simpara>
754
+
Indicates that encoding is S/MIME.
755
+
</simpara>
756
+
</listitem>
757
+
</varlistentry>
758
+
<varlistentry xml:id="constant.openssl-encoding-der">
759
+
<term>
760
+
<constant>OPENSSL_ENCODING_DER</constant>
761
+
(<type>int</type>)
762
+
</term>
763
+
<listitem>
764
+
<simpara>
765
+
Indicates that encoding is <acronym>DER</acronym>.
766
+
</simpara>
767
+
</listitem>
768
+
</varlistentry>
769
+
<varlistentry xml:id="constant.openssl-encoding-pem">
770
+
<term>
771
+
<constant>OPENSSL_ENCODING_PEM</constant>
772
+
(<type>int</type>)
773
+
</term>
774
+
<listitem>
775
+
<simpara>
776
+
Indicates that encoding is <acronym>PEM</acronym>.
777
+
</simpara>
778
+
</listitem>
779
+
</varlistentry>
780
+
</variablelist>
781
+
</section>
581
782
</appendix>
582
-

583
783
<!-- Keep this comment at the end of the file
584
784
Local variables:
585
785
mode: sgml
...
...
@@ -600,4 +800,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
600
800
vim: et tw=78 syn=sgml
601
801
vi: ts=1 sw=1
602
802
-->
603
-

604
803



Tools (Spanish Manual)