[ci skip] comment

ndossche · ndossche · commit 9a276a070390 · 2025-12-22T00:28:18.000+01:00
diff --git a/ext/phar/util.c b/ext/phar/util.c
@@ -709,7 +709,8 @@ static inline void phar_set_pharfp(phar_archive_data *phar, php_stream *fp)
 	PHAR_G(cached_fp)[phar->phar_pos].fp = fp;
 }
 
-/* initialize a phar_archive_data's read-only fp for existing phar data */
+/* Initialize a phar_archive_data's read-only fp for existing phar data.
+ * The stream is owned by the `phar` object and must not be closed manually. */
 php_stream *phar_open_archive_fp(phar_archive_data *phar) /* {{{ */
 {
 	php_stream *stream = phar_get_pharfp(phar);

Original file line number	Diff line number	Diff line change
`@@ -709,7 +709,8 @@ static inline void phar_set_pharfp(phar_archive_data phar, php_stream fp)`
`709`	`709`	`PHAR_G(cached_fp)[phar->phar_pos].fp = fp;`
`710`	`710`	`}`
`711`	`711`
`712`		`-/* initialize a phar_archive_data's read-only fp for existing phar data */`
	`712`	`+/* Initialize a phar_archive_data's read-only fp for existing phar data.`
	`713`	+ * The stream is owned by the `phar` object and must not be closed manually. */
`713`	`714`	`php_stream phar_open_archive_fp(phar_archive_data phar) /* {{{ */`
`714`	`715`	`{`
`715`	`716`	`php_stream *stream = phar_get_pharfp(phar);`