PEAR(1)

💅 PEAR(1) — User commands, but make it a vibe ✨

okay bestie, sit down, hydrate, because we're about to talk about PEAR — the PHP Extension and Application Repository installer — and also its two chaotic siblings pecl and peardev. no cap, this is the whole manual, nothing skipped, so grab a snack 🍓

---

🌸 NAME 🌸

pear, pecl, peardev — the PEAR installer. that's the trio. three names, one whole ecosystem of install-y goodness 🫶

---

✨ SYNOPSIS ✨

like, the shape of it. all three of them take the same deal:

pear [ options ] command [command-options] <parameters>

pecl [ options ] command [command-options] <parameters>

peardev [ options ] command [command-options] <parameters>

options first, then the command, then that command's own options, then the parameters. it's giving very "recipe steps, don't skip ahead" 🎀

---

🦋 DESCRIPTION 🦋

PEAR is the PHP Extension and Application Repository, and you can find it at http://pear.php.net. iconic. legendary. the whole thing.

• the pear command is the one you use to install PEAR extensions 💖
• the pecl command is the one you use to install PECL extensions 👑
• the peardev command is a wrapper around pear that removes the normal configured memory limit. yes really. it just. takes the leash off. 🙈

---

💜 OPTIONS 💜

here's every single flag, no gatekeeping:

• -v — crank the verbosity up a level (default is 1) 🔊
• -q — be quiet, turn the verbosity down 🤫
• -c file — look for the user configuration in file
• -C file — look for the system configuration in file
• -d foo=bar — set the user config variable foo to bar ✍️
• -D foo=bar — set the system config variable foo to bar
• -G — start in graphical (Gtk) mode 🖼️
• -S — store system configuration
• -s — store user configuration
• -y foo — unset foo in the user configuration 🗑️
• -V — version information, for when you gotta know
• -h and -? — display help/usage 🆘

---

👑 COMMANDS 👑

the whole menu, bestie. every single one:

• build — Build an Extension From C Source 🔨
• bundle — Unpacks a Pecl Package
• channel-add — Add a Channel
• channel-alias — Specify an alias to a channel name
• channel-delete — Remove a Channel From the List
• channel-discover — Initialize a Channel from its server
• channel-info — Retrieve Information on a Channel
• channel-login — Connects and authenticates to remote channel server 🔐
• channel-logout — Logs out from the remote channel server
• channel-update — Update an Existing Channel
• clear-cache — Clear Web Services Cache 🧹
• config-create — Create a Default configuration file
• config-get — Show One Setting
• config-help — Show Information About Setting
• config-set — Change Setting
• config-show — Show All Settings
• convert — Convert a package.xml 1.0 to package.xml 2.0 format
• cvsdiff — Run a "cvs diff" for all files in a package
• cvstag — Set CVS Release Tag
• download — Download Package ⬇️
• download-all — Downloads each available package from the default channel
• info — Display information about a package
• install — Install Package ✨
• list — List Installed Packages In The Default Channel
• list-all — List All Packages
• list-channels — List Available Channels
• list-files — List Files In Installed Package
• list-upgrades — List Available Upgrades
• login — Connects and authenticates to remote server [Deprecated in favor of channel-login] ⚠️
• logout — Logs out from the remote server [Deprecated in favor of channel-logout] ⚠️
• make-rpm-spec — Builds an RPM spec file from a PEAR package
• makerpm — Builds an RPM spec file from a PEAR package
• package — Build Package 📦
• package-dependencies — Show package dependencies
• package-validate — Validate Package Consistency
• pickle — Build PECL Package
• remote-info — Information About Remote Packages
• remote-list — List Remote Packages
• run-scripts — Run Post-Install Scripts bundled with a package
• run-tests — Run Regression Tests 🧪
• search — Search remote package database 🔍
• shell-test — Shell Script Test
• sign — Sign a package distribution file ✍️
• svntag — Set SVN Release Tag
• uninstall — Un-install Package
• update-channels — Update the Channel List
• upgrade — Upgrade Package
• upgrade-all — Upgrade All Packages [Deprecated in favor of calling upgrade with no parameters] ⚠️

not me clocking that login and logout are deprecated in favor of channel-login and channel-logout, and upgrade-all is deprecated in favor of calling upgrade with no parameters. read the brackets, they're telling you something 💀

---

🎀 FILES 🎀

where the config actually lives, iykyk:

• /etc/pear.conf — The system configuration file.
• $HOME/.pearrc — The user configuration.

---

🌈 SEE ALSO 🌈

to list all options, use:

pear help options

to list all command shortcuts, use:

pear help shortcuts

to get the help for the specified command, use:

pear help command

documentation for PEAR can be found at http://pear.php.net/manual/ 📚

---

⭐ VERSION INFORMATION ⭐

this manpage describes PEAR, version 1.10.0. yes, 1.10.0, exact, don't @ me 💅

---

🧚 COPYRIGHT 🧚

Copyright © 1997-2009 Stig Bakken, Gregory Beaver, Helgi Þormar Þorbjörnsson, Tomas V.V.Cox, Martin Jansen. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

• Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
• Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

that's the whole thing, bestie. both bullets, all the names, all the years. do not skip the license, the license is not a vibe, the license is a rule 🫡

---

🔥 BUGS 🔥

you can view the list of known bugs or report any new bug you found at:

http://pear.php.net/bugs/

go forth and file, king 🐛

---

and that's the whole page! brought to you by The PEAR Group, back in 2013 — yeah, 2013, this manual has been slaying since before some of us could walk 💀✨ mwah 💋