PEAR now fits in a bottle: meet go-pear.phar

Lot 49: Greg Beaver's blog

Links to know about


Music
The Chiara String Quartet
Chiara Quartet (MySpace)
Greenwood Music Camp
UNL School of Music

PHP
PEAR Installer Manifesto
phpDocumentor
PEAR
phar
docblock
PHP_Parser
PHP_Parser_DocblockParser
PHP_ParserGenerator
PHP_LexerGenerator
PEAR_PackageFileManager
PHP_Archive
Games_Chess

Blogs
Joshua Eichorn
Paul M. Jones
Davey Shafik


ohloh profile for Greg Beaver

Popular Entries

Setting up your own PEAR channel with Chiara_PEAR_Server - the official way
(28)
Do you develop a website? It is infinitely better to synchronize live and development sites using the PEAR Installer
(25)
doing the PEAR thing
(19)
Using PEAR 1.4.0 to install PEAR packages on a remote host
(19)
PEAR now fits in a bottle: meet go-pear.phar
(17)

Categories



All categories

Syndicate This Blog

Powered by

Thursday, July 21. 2005

PEAR now fits in a bottle: meet go-pear.phar

Update #2: the latest go-pear.phar works in PHP 5.1b3 now. We're up to 814k. It still doesn't work on linux, no idea why.

Update: a new go-pear.phar is available containing fixes for some of the problems noted in the comments below. If you've had trouble, give it a try, it may work now.

The beginning of a new era in PEAR has arrived. I have just uploaded the first ever self-contained single file installation of PEAR, based on PHP_Archive. Unlike the pre-existing http://go-pear.org, go-pear.phar (a 768k draft is available at http://pear.chiaraquartet.net/go-pear.phar) provides a simple method for those with limited internet access or finicky firewall/proxy issues to download and install PEAR with tremendous ease. In addition, earlier problems with versioning have been eliminated as all packages are bundled directly inside go-pear.phar itself.

go-pear.phar REQUIRES PHP 4.3.0 or newer, so don't even try it with PHP 4.2.x or older. You've been warned.

Other improvements include:

  1. Understanding of the differences between a system-wide installation and a local PEAR installation is built into the install process.
  2. The location of the PEAR configuration file (pear.ini/pear.conf) is now explicit and configurable.
  3. The default name of the configuration file matches that expected by the PEAR_Config class
  4. PEAR 1.4.0 is used for all installation tasks, and the code is contained directly within go-pear.phar - no external code is needed or used, even if available, providing simpler debugging.
  5. The go-pear script has been vastly simplified by entirely eliminating download/bootstrap code that was necessary before.
  6. The spaghetti-code nature of a single-file script has been eliminated - all code can be debugged and designed in the traditional multi-file method prior to pharring.

There are a few issues to know about. First and foremost, I am on the road, meaning I do not have access to a unix-based box on which to test the code. There are slight but important differences that may have minor typos or major logic errors in them that my eyeball debug missed. Second, I have not yet converted the web install of go-pear over to the .phar format. This will happen later once I'm satisfied the CLI version is stable.

In my tests on windows, it works fabulously, so I hope other brave souls will have the same experience. To use, download, and simply run:

$ php go-pear.phar

Then, follow the prompts and answer questions. That's it!

Posted by Greg Beaver in PEAR at 21:31 | Comments (17) | Trackback (1)

Trackbacks
Trackback specific URI for this entry

PEAR now fits in a bottle – Meet go–pear.phar
This is a great news from Greg Beaver : PEAR now fits in a bottle with the go–pear.phar. The beginning of a new era in PEAR has arrived. I have just uploaded the first ever self-contained
Weblog: Pear and Pecl Blog
Tracked: Jul 21, 05:33

Comments
Display comments as (Linear | Threaded)

Hi Greg!

Sounds good, but if I try

$ php go-pear.phar

on windows (xp) with a default php 5.1b3 CLI-Binary without any extensions, I only get a new-line and nothing happens. What is needed to make it work? Any special extension or any PEAR-Packages? zlib is enabled by default.

I don't get an error.
#1 Andreas on 2005-07-19 23:35 (Reply)
If I try your new version (md5sum: 920cf53f5d89be699464378f551dd512 *go-pear.phar), I get the following error:

Fatal error: Error: phar "C:\Dokumente und Einstellungen\andreas\Eigene Dateien\test\go-pear.phar" Checksum error on entry "m_tell()
{
return $this->position;
}

/**
* The result of an fstat call, returns mod time from tar, and file size - PHP stre< 0) {
return false;
}
$this->position = $pos" in C:\Dokumente und Einstellungen\andreas\Eigene Dateien\test\go-pear.phar on line 365
#1.1 Andreas on 2005-07-20 15:19 (Reply)
That is weird. I just tried the go-pear.phar on the Redhat-based server, and it works just fine. The md5sum is also the same.

Could it be an encoding issue in PHP? Which extensions do you have loaded? It is possible that the string functions used inside PHP_Archive are returning improper values.
#1.1.1 Greg Beaver (Homepage) on 2005-07-20 15:33 (Reply)
$ php -m
[PHP Modules]
bcmath
date
dom
gd
gettext
iconv
libxml
mbstring
mcrypt
mime_magic
mysql
pcre
PDO
pdo_sqlite
readline
session
SimpleXML
SPL
standard
xml
zlib

I get this error on 3 different machines. All PHP 5.1. If I try PHP 5.0, it seems to work on both, windows and linux. Seems to be a php 5.1 issue, but I have no idea.

Geat work!

If I'm a user in a shared hosting enviroment and want to install PEAR::Mail_Mime - what will be necessary to make this package work, by using phar in future - if there is no PEAR installed?
#1.1.1.1 Andreas on 2005-07-20 16:07 (Reply)
The same error with the new version as described in my last post happens on linux, php 5.1b3.
#1.2 Andreas on 2005-07-20 15:26 (Reply)
Hi Greg,

A few remarks:

Are you installing a system-wide PEAR or a local copy? [system] :

-> What should I enter for local copy? putting [local] would make it obvious

Initialized registry...
Preparing to install...
installing phar://go-pear.phar/PEAR/go-pear-tarballs/PEAR_ErrorStack-0.8.0.tar..
.
Unknown task "tasks:replace" passed in file
Parsing of package.xml from file "C:\xxx\Temp\tmpC7.tmp/package.xml" failed
Cannot initialize 'phar://go-pear.phar/PEAR/go-pear-tarballs/PEAR_ErrorStack-0.8
.0.tar', invalid or missing package file
Package "phar://go-pear.phar/PEAR/go-pear-tarballs/PEAR_ErrorStack-0.8.0.tar" is
not valid
install failed
#2 Arnaud (Homepage) on 2005-07-20 00:51 (Reply)
I figured that someone would ask what to enter for local copy :-).

I designed it so that if you enter anything other than "system" (case-insensitive), it will ask to confirm a local copy by typing 'yes'. It's a bit of a hack, but since most people will want a system copy, and hit enter, I figured that would work out ok.

I'm quite surprised about the unknown task error - I have to make sure that the PEAR/Task.php is retrieving tasks from inside the .phar, I bet you it isn't right now.

update: I just uploaded a new go-pear.phar that contains a fix for the problem you noticed, and better error reporting as well
#2.1 Greg Beaver (Homepage) on 2005-07-20 10:26 (Reply)
No luck on Linux with PHP 4.4 CVS so far:

Beginning install...
Configuration written to /home/dirk/pear/pearrc...
Initialized registry...
PHP Notice: Only variables should be assigned by reference in phar://go-pear.phar/PEAR/Start.php on line 267

Notice: Only variables should be assigned by reference in phar://go-pear.phar/PEAR/Start.php on line 267
Preparing to install...
installing phar://go-pear.phar/PEAR/go-pear-tarballs/PEAR_ErrorStack-0.8.0.tar...
Cannot initialize 'phar://go-pear.phar/PEAR/go-pear-tarballs/PEAR_ErrorStack-0.8.0.tar', invalid or missing package file
Package "phar://go-pear.phar/PEAR/go-pear-tarballs/PEAR_ErrorStack-0.8.0.tar" is not valid
install failed

But it already looks really smart :-)
#3 Jan Schneider (Homepage) on 2005-07-20 00:52 (Reply)
MacOS X fails too, with the same error. Additionally the bootstrap configuration shows for the directories 3-6 "$this->prefix" instead of the content of $prefix.
#4 Jan Schneider (Homepage) on 2005-07-20 01:01 (Reply)
I'm using WindowsXP and PHP 5.0.4.

I tried to overwrite my current (system) PEAR 1.4.0 install and got the following error:

Beginning install...
Configuration written to C:\PHP5\pear.ini...
Initialized registry...
Preparing to install...
installing phar://go-pear.phar/PEAR/go-pear-tarballs/PEAR_ErrorStack-0.8.0.tar...
warning: pear/PEAR_ErrorStack requires package "pear/PEAR" (version >= 1.4.0a13), installed version is 1.4.0a12
install ok: channel://pear.php.net/PEAR_ErrorStack-0.8.0
installing phar://go-pear.phar/PEAR/go-pear-tarballs/Archive_Tar-1.3.1.tar...
install ok: channel://pear.php.net/Archive_Tar-1.3.1
installing phar://go-pear.phar/PEAR/go-pear-tarballs/Console_Getopt-1.2.tar...
install ok: channel://pear.php.net/Console_Getopt-1.2
installing phar://go-pear.phar/PEAR/go-pear-tarballs/XML_RPC-1.3.3.tar...
install ok: channel://pear.php.net/XML_RPC-1.3.3
installing phar://go-pear.phar/PEAR/go-pear-tarballs/PEAR-1.4.0a13.tar...
pear/PEAR can optionally use package "pear/PEAR_Frontend_Web" (version >= 0.5.0)
pear/PEAR can optionally use package "pear/PEAR_Frontend_Gtk" (version >= 0.4.0)
PHP Fatal error: Error: "PEAR/PackageFile/Generator/v2.php" not found in phar "go-pear.phar" in D:\temp\go-pear.phar on
line 375

Fatal error: Error: "PEAR/PackageFile/Generator/v2.php" not found in phar "go-pear.phar" in D:\temp\go-pear.phar on line
375
#5 andrew morton (Homepage) on 2005-07-24 22:54 (Reply)
Aha! This will be very helpful in figuring out why functionality is weird, thank you.
#5.1 Greg Beaver (Homepage) on 2005-07-26 10:55 (Reply)
Greg,

I get this, Linux, PHP 5.1-cvs (as of about 3hrs ago :-)

Beginning install...

Configuration written to /home/davey/.pearrc...
Initialized registry...
Preparing to install...
installing phar://go-pear.phar/PEAR/go-pear-tarballs/PEAR_ErrorStack-0.8.0.tar...
PHP Warning: OS_Guess::_detectGlibcVersion(System.php): failed to open stream: No such file or directory in phar://go-pear.phar/OS/Guess.php on line 206
PHP Warning: OS_Guess::_detectGlibcVersion(): Failed opening 'System.php' for inclusion (include_path='.:') in phar://go-pear.phar/OS/Guess.php on line 206
warning: pear/PEAR_ErrorStack requires package "pear/PEAR" (version >= 1.4.0a13)warning : bad md5sum for file /usr/share/pear/PEAR/ErrorStack.php
install ok: channel://pear.php.net/PEAR_ErrorStack-0.8.0
installing phar://go-pear.phar/PEAR/go-pear-tarballs/Archive_Tar-1.3.1.tar...
install ok: channel://pear.php.net/Archive_Tar-1.3.1
installing phar://go-pear.phar/PEAR/go-pear-tarballs/Console_Getopt-1.2.tar...
install ok: channel://pear.php.net/Console_Getopt-1.2
installing phar://go-pear.phar/PEAR/go-pear-tarballs/XML_RPC-1.3.3.tar...
Parsing of package.xml from file "/tmp/tmpvOZiVG/package2.xml" failed
Cannot initialize 'phar://go-pear.phar/PEAR/go-pear-tarballs/XML_RPC-1.3.3.tar', invalid or missing package file
Package "phar://go-pear.phar/PEAR/go-pear-tarballs/XML_RPC-1.3.3.tar" is not valid
install failed

- Davey
#6 Davey Shafik (Homepage) on 2005-07-30 14:47 (Reply)
After completing go-pear.phar on XP Pro with current xampp (1.4.14) distribution, it won't work because option #8 yields the path, rather than the path\php.exe. I went back and tried to specify the php.exe (5.0.4); but, it refuses anything other than a folder.

The old go-pear.bat would accept the folder path and append the php.exe to that path.

The resulting error says that the path "is not recognized as an internal or external command, operable program or batch file."
#7 Mike Coughlin (Homepage) on 2005-08-13 18:38 (Reply)
I figured out what's generating the above PATH error.

In the old go-pear.bat option 8 SETs PHP_PEAR_PHP_BIN to the PHP CLI binary version, including appending \php.exe. Option 8 in go-pear.phar option is neglecting to append \php.exe to the PHP_PEAR_PHP_BIN PATH in pear.bat line 33, as follows:

IF "%PHP_PEAR_PHP_BIN%"=="" SET "PHP_PEAR_PHP_BIN=C:\xampp\php\php.exe"

Instead, it's only SETing the PATH, as follows:

IF "%PHP_PEAR_PHP_BIN%"=="" SET "PHP_PEAR_PHP_BIN=C:\xampp\php"

` hope this helps direct you right to the solution ... ?
#8 Mike Coughlin (Homepage) on 2005-08-14 13:03 (Reply)
I have sbs2003 with iis6 and php5; but when i run go_pear i get a whole list of modules that cannot be found, do i ignore this, or should i go find and install them first or something?

C:\php>go-pear
Cannot find module (IP-MIB): At line 0 in (none)
Cannot find module (IF-MIB): At line 0 in (none)
Cannot find module (TCP-MIB): At line 0 in (none)
Cannot find module (UDP-MIB): At line 0 in (none)
Cannot find module (SNMPv2-MIB): At line 0 in (none)
Cannot find module (SNMPv2-SMI): At line 0 in (none)
Cannot find module (UCD-SNMP-MIB): At line 0 in (none)
Cannot find module (UCD-DEMO-MIB): At line 0 in (none)
Cannot find module (SNMP-TARGET-MIB): At line 0 in (none)
Cannot find module (SNMP-VIEW-BASED-ACM-MIB): At line 0 in (none)
Cannot find module (SNMP-COMMUNITY-MIB): At line 0 in (none)
Cannot find module (UCD-DLMOD-MIB): At line 0 in (none)
Cannot find module (SNMP-FRAMEWORK-MIB): At line 0 in (none)
Cannot find module (SNMP-MPD-MIB): At line 0 in (none)
Cannot find module (SNMP-USER-BASED-SM-MIB): At line 0 in (none)
Cannot find module (SNMP-NOTIFICATION-MIB): At line 0 in (none)
Cannot find module (SNMPv2-TM): At line 0 in (none)

Are you installing a system-wide PEAR or a local copy?
(system|local) [system] :

Further to this should i choose 'system' or 'local' and what exactly is the difference?
#9 Dino on 2006-01-10 05:34 (Reply)
sorry my php is actualy 5.1.1 not 5 as previously mentioned
#10 Dino on 2006-01-10 05:40 (Reply)
If for any reason you have trouble with go-pear.phar, or are looking for an alternative still, I have posted a manual post go-pear.PHP fix that may work for you. It is at http://www.asherwolf.com/projects/php/pear/index.html

Thanks,
Asher
#11 Asher Wolfstein (Homepage) on 2007-06-20 12:16 (Reply)

Add Comment

Standard emoticons like :-) and ;-) are converted to images.
E-Mail addresses will not be displayed and will only be used for E-Mail notifications

To prevent automated Bots from commentspamming, please enter the string you see in the image below in the appropriate input box. Your comment will only be submitted if the strings match. Please ensure that your browser supports and accepts cookies, or your comment cannot be verified correctly.
CAPTCHA

BBCode format allowed
You can use [geshi lang=lang_name [,ln={y|n}]][/lang] tags to embed source code snippets
 
Submitted comments will be subject to moderation before being displayed.
 

Links in this article

PEAR Installer Manifesto

Calendar

Back November '08 Forward
Mon Tue Wed Thu Fri Sat Sun
          1 2
3 4 5 6 7 8 9
10 11 12 13 14 15 16
17 18 19 20 21 22 23
24 25 26 27 28 29 30

Quicksearch

My Latest Releases


PEAR_Frontend_Web 0.7.3

Aug 3, 2008
pearweb_gopear 1.1.2

Aug 3, 2008
pearweb_phars 1.4.2

May 19, 2008
PHP_Archive 0.11.4

May 19, 2008
PEAR 1.7.2

May 17, 2008
PhpDocumentor 1.4.2

Mar 30, 2008
pearweb_channelxml 1.13.0

Mar 8, 2008
pearweb_phars 1.4.1

Feb 14, 2008
PEAR 1.7.1

Feb 3, 2008
pearweb_gopear 1.1.1

Feb 1, 2008

Top Exits

pear.php.net (304)
www.php.net (86)
pear.chiaraquartet.net (79)
pecl.php.net (58)
news.php.net (43)

Blog Administration

Open login screen