PHP/resource/stream - Revision history

Woozle at 01:36, 11 February 2026

2026-02-11T01:36:44Z

← Older revision		Revision as of 01:36, 11 February 2026
Line 9:		Line 9:
	**** Maybe <code>{{l/pfx\|PHP/fx/\|feof}}()</code> would work? '''PROBLEM''': although docs say this can be used on a stream, they also say it has to have been opened with <code>{{l/pfx\|PHP/fx/\|fopen}}()</code> or <code>{{l/pfx\|PHP/fx/\|fsockopen}}()</code>, which rules out process-fed streams created with functions like <code>{{l/pfx\|PHP/fx/\|ssh2_exec}}()</code>.		**** Maybe <code>{{l/pfx\|PHP/fx/\|feof}}()</code> would work? '''PROBLEM''': although docs say this can be used on a stream, they also say it has to have been opened with <code>{{l/pfx\|PHP/fx/\|fopen}}()</code> or <code>{{l/pfx\|PHP/fx/\|fsockopen}}()</code>, which rules out process-fed streams created with functions like <code>{{l/pfx\|PHP/fx/\|ssh2_exec}}()</code>.
	*** Does empty-string still correctly signal that the process has completed?		*** Does empty-string still correctly signal that the process has completed?
			**** I ''think'' we have to assume that this is true for <code>{{l/pfx\|PHP/fx/\|stream_get_contents}}()</code>: it will never return empty as long as the process is active. (Maybe in non-blocking mode, it blocks until there is at least one byte, or something?)
	*** What happens if the process has ''not'' completed (so there's no new data yet) -- how can we tell that there might be more?		*** What happens if the process has ''not'' completed (so there's no new data yet) -- how can we tell that there might be more?
	==Links==		==Links==
	===~~Official~~===		===Reference===
	* [https://www.php.net/manual/en/ref.stream.php Stream Functions]		* [https://www.php.net/manual/en/ref.stream.php Stream Functions]

Woozle at 01:29, 11 February 2026

2026-02-11T01:29:30Z

← Older revision		Revision as of 01:29, 11 February 2026
Line 5:		Line 5:
	* If a stream is set to blocking mode (with <code>{{l/pfx\|PHP/fx/\|stream_set_blocking}}({{arg\|stream resource}}, TRUE);</code>), then EoS (end-of-stream) is indicated by the return of an empty string.		* If a stream is set to blocking mode (with <code>{{l/pfx\|PHP/fx/\|stream_set_blocking}}({{arg\|stream resource}}, TRUE);</code>), then EoS (end-of-stream) is indicated by the return of an empty string.
	** Questions about how it works in non-blocking mode:		** Questions about how it works in non-blocking mode:
	*** How do we detect EoS in ''non''-blocking mode?		*** How do we detect EoS in ''non''-blocking mode? Some tentative leads:
	**** [https://www.php.net/manual/en/stream.constants.php#constant.stream-notify-completed STREAM_NOTIFY_COMPLETED] (as used by <code>{{l/pfx\|PHP/fx/\|~~stream_notification_callback~~}}()</code>) ~~seems possibly relevant here~~.		**** We could set the stream with an event-callback (see {{l/pfx\|PHP/fx/\|stream_notification_callback}}) and look for [https://www.php.net/manual/en/stream.constants.php#constant.stream-notify-completed STREAM_NOTIFY_COMPLETED] events. '''PROBLEM''': docs say this is only supported for http and ftp.
			**** Maybe <code>{{l/pfx\|PHP/fx/\|feof}}()</code> would work? '''PROBLEM''': although docs say this can be used on a stream, they also say it has to have been opened with <code>{{l/pfx\|PHP/fx/\|fopen}}()</code> or <code>{{l/pfx\|PHP/fx/\|fsockopen}}()</code>, which rules out process-fed streams created with functions like <code>{{l/pfx\|PHP/fx/\|ssh2_exec}}()</code>.
	*** Does empty-string still correctly signal that the process has completed?		*** Does empty-string still correctly signal that the process has completed?
	*** What happens if the process has ''not'' completed (so there's no new data yet) -- how can we tell that there might be more?		*** What happens if the process has ''not'' completed (so there's no new data yet) -- how can we tell that there might be more?

Woozle at 18:03, 10 February 2026

2026-02-10T18:03:21Z

← Older revision		Revision as of 18:03, 10 February 2026
Line 3:		Line 3:
	Although there are a lot of functions that handle streams in PHP, how to properly use these functions is often not explained very well. I'm having to reverse-engineer a lot through trial and error.		Although there are a lot of functions that handle streams in PHP, how to properly use these functions is often not explained very well. I'm having to reverse-engineer a lot through trial and error.
	==Tentative Conclusions==		==Tentative Conclusions==
	* If a stream is set to blocking mode (with <code>~~[https:~~//~~www.php.net~~/~~manual/en/function.stream-set-blocking.php~~ stream_set_blocking]({{arg\|stream resource}}, TRUE);</code>), then EoS (end-of-stream) is indicated by the return of an empty string.		* If a stream is set to blocking mode (with <code>{{l/pfx\|PHP/fx/\|stream_set_blocking}}({{arg\|stream resource}}, TRUE);</code>), then EoS (end-of-stream) is indicated by the return of an empty string.
	** Questions about how it works in non-blocking mode:		** Questions about how it works in non-blocking mode:
	*** How do we detect EoS in ''non''-blocking mode?		*** How do we detect EoS in ''non''-blocking mode?
	**** [https://www.php.net/manual/en/stream.constants.php#constant.stream-notify-completed STREAM_NOTIFY_COMPLETED] (as used by ~~[https://www.php.net~~/~~manual~~/en/~~function.stream-notification-callback.php <code>~~stream_notification_callback()</code>]) seems possibly relevant here.		**** [https://www.php.net/manual/en/stream.constants.php#constant.stream-notify-completed STREAM_NOTIFY_COMPLETED] (as used by <code>{{l/pfx\|PHP/fx/\|stream_notification_callback}}()</code>) seems possibly relevant here.
	*** Does empty-string still correctly signal that the process has completed?		*** Does empty-string still correctly signal that the process has completed?
	*** What happens if the process has ''not'' completed (so there's no new data yet) -- how can we tell that there might be more?		*** What happens if the process has ''not'' completed (so there's no new data yet) -- how can we tell that there might be more?

Woozle at 17:49, 10 February 2026

2026-02-10T17:49:27Z

← Older revision		Revision as of 17:49, 10 February 2026
Line 6:		Line 6:
	** Questions about how it works in non-blocking mode:		** Questions about how it works in non-blocking mode:
	*** How do we detect EoS in ''non''-blocking mode?		*** How do we detect EoS in ''non''-blocking mode?
			**** [https://www.php.net/manual/en/stream.constants.php#constant.stream-notify-completed STREAM_NOTIFY_COMPLETED] (as used by [https://www.php.net/manual/en/function.stream-notification-callback.php <code>stream_notification_callback()</code>]) seems possibly relevant here.
	*** Does empty-string still correctly signal that the process has completed?		*** Does empty-string still correctly signal that the process has completed?
	*** What happens if the process has ''not'' completed (so there's no new data yet) -- how can we tell that there might be more?		*** What happens if the process has ''not'' completed (so there's no new data yet) -- how can we tell that there might be more?

Woozle at 17:44, 10 February 2026

2026-02-10T17:44:02Z

← Older revision		Revision as of 17:44, 10 February 2026
Line 1:		Line 1:
	{{fmt/title\|stream ~~resources~~ in PHP}}		{{fmt/title\|stream-type "resource" demiobjects in PHP}}
	==About==		==About==
	Although there are a lot of functions that handle streams in PHP, how to properly use these functions is often not explained very well. I'm having to reverse-engineer a lot through trial and error.		Although there are a lot of functions that handle streams in PHP, how to properly use these functions is often not explained very well. I'm having to reverse-engineer a lot through trial and error.
Line 8:		Line 8:
	*** Does empty-string still correctly signal that the process has completed?		*** Does empty-string still correctly signal that the process has completed?
	*** What happens if the process has ''not'' completed (so there's no new data yet) -- how can we tell that there might be more?		*** What happens if the process has ''not'' completed (so there's no new data yet) -- how can we tell that there might be more?
			==Links==
			===Official===
			* [https://www.php.net/manual/en/ref.stream.php Stream Functions]

Woozle: Created page with "{{fmt/title|stream resources in PHP}} ==About== Although there are a lot of functions that handle streams in PHP, how to properly use these functions is often not explained ve..."

2026-02-10T17:37:29Z

Created page with "{{fmt/title|stream resources in PHP}} ==About== Although there are a lot of functions that handle streams in PHP, how to properly use these functions is often not explained ve..."

New page

{{fmt/title|stream resources in PHP}}
==About==
Although there are a lot of functions that handle streams in PHP, how to properly use these functions is often not explained very well. I'm having to reverse-engineer a lot through trial and error.
==Tentative Conclusions==
* If a stream is set to blocking mode (with <code>[https://www.php.net/manual/en/function.stream-set-blocking.php stream_set_blocking]({{arg|stream resource}}, TRUE);</code>), then EoS (end-of-stream) is indicated by the return of an empty string.
** Questions about how it works in non-blocking mode:
*** How do we detect EoS in ''non''-blocking mode?
*** Does empty-string still correctly signal that the process has completed?
*** What happens if the process has ''not'' completed (so there's no new data yet) -- how can we tell that there might be more?