printer_list

Description

array printer_list ( int enumtype [, string name [, int level]] )

The function enumerates available printers and their capabilities. level sets the level of information request. Can be 1,2,4 or 5. enumtype must be one of the following predefined constants:

PRINTER_ENUM_LOCAL: enumerates the locally installed printers.
PRINTER_ENUM_NAME: enumerates the printer of name, can be a server, domain or print provider.
PRINTER_ENUM_SHARED: this parameter can't be used alone, it has to be OR'ed with other parameters, i.e. PRINTER_ENUM_LOCAL to detect the locally shared printers.
PRINTER_ENUM_DEFAULT: (Win9.x only) enumerates the default printer.
PRINTER_ENUM_CONNECTIONS: (WinNT/2000 only) enumerates the printers to which the user has made connections.
PRINTER_ENUM_NETWORK: (WinNT/2000 only) enumerates network printers in the computer's domain. Only valid if level is 1.
PRINTER_ENUM_REMOTE: (WinNT/2000 only) enumerates network printers and print servers in the computer's domain. Only valid if level is 1.

例子 1. printer_list() example


<?php
/* detect locally shared printer */
var_dump(printer_list(PRINTER_ENUM_LOCAL | PRINTER_ENUM_SHARED));
?>

add a note User Contributed Notes

gabriel dot smagghe at laposte dot net
14-Oct-2005 04:33


You can use all the array data, with no crash.

For that you can do this :



$getprt=printer_list(PRINTER_ENUM_LOCAL| PRINTER_ENUM_SHARED );



if ($debugprt){echo "<pre> get prt";

    print_r($getprt);

    echo "</pre>";

    echo count($getprt);

}

$printers = serialize($getprt);

//echo $printers ;

$pp=str_replace _

(";s:11:\"DESCRIPTION\";",";s:4:\"DESC\";",_

str_replace(";s:7:\"COMMENT\";",";s:4:\"COMM\";",$printers));

$printers=unserialize($pp);

if ($debugprt){echo "<pre> pp :";



    print_r($printers);

    echo "</pre>";

    echo count($printers);

}



An that's ok

jt at jtis dot de
06-Dec-2004 07:19


As saidyjade mentioned below, printer_list crashes Apache when you pound the resulting array too much. I don't know why this happens, somebody should look deeper into the subject...

I have found out, contrary to saidyjade, that also just getting the NAME attribute (and remember, it's case-sensitive! :-) can crash Apache.



Here's what I had:

<?php

    foreach (printer_list(PRINTER_ENUM_CONNECTIONS) as $printer)

        echo "<option value=\"" . addslashes(strtoupper($printer["NAME"])) . "\">" . strtoupper($printer["NAME"]) . "\n";

?>

This snippet worked alright, whereas

<?php

    foreach (printer_list(PRINTER_ENUM_CONNECTIONS) as $printer)

        echo "<option value=\"" . addslashes(strtoupper($printer["NAME"])) . "\"" . ((strtoupper($printer["NAME"])) ? " selected" : "") . ">" . strtoupper($printer["NAME"]) . "\n";

?>

crashed Apache everytime the page was loaded.



I played around a bit and found this snippet not crashing:

<?php

    foreach (printer_list(PRINTER_ENUM_CONNECTIONS) as $printer)

    {

        $curprin = strtoupper($printer["NAME"]);

        echo "<option value=\"" . addslashes($curprin) . "\"" . (($curprin == $user["drucker"]) ? " selected" : "") . ">$curprin\n";

    }

?>



So, in essence you just need to be careful about how much you use the array and if necessary define help variables that you can use as much as you want.



Hope this saves somebody some more minutes...

saidyjade at hotmail dot com
15-Jun-2003 02:52


You can still get the "NAME" of printers through the printer_list as only the array keys "DESCRIPTION" and "COMMENT" crash and not the "NAME" key.



$list_printers = printer_list(PRINTER_ENUM_LOCAL |

PRINTER_ENUM_SHARED);



// get the name of the first returned printer

//(you can add array walk function to get all printer names if you wish.. but I am lazy)



$this_printer = $list_printers[0]["NAME"];



// open a connection to your printer

$my_printer = printer_open($this_printer);



.. blah blah



The output of var_dump (as an example)



var_dump( printer_list(PRINTER_ENUM_LOCAL | PRINTER_ENUM_SHARED) );



array(1) {

  [0]=> array(3) {

  ["NAME"]=> string(14) "Canon BJC-4550"

  ["DESCRIPTION"]=> string(30) "Canon BJC-4550,Canon BJC-4550,"

  ["COMMENT"]=> string(0) "This is my funky printer!" } }



As you can see var_dump (under variable functions in the manual) shows and/or retrieves the corrent information but if you try to place into a variable or read the variable it crashes either apache using php4apache.dll or php when you the command line client or cgi.



So as long as you do not get the comment or description it will list your printers.

add a note