OSS_SNMP
A PHP SNMP library that simplifies network device interaction by abstracting away complex MIBs and OIDs.
What is OSS_SNMP?
OSS_SNMP is a PHP library that provides a simplified, developer-friendly interface for working with SNMP (Simple Network Management Protocol) on network devices. It abstracts away the complexity of MIBs and OIDs, allowing network engineers and developers to retrieve and manage network data through intuitive PHP methods instead of dealing with low-level SNMP details.
Network engineers, DevOps professionals, and PHP developers who need to automate network monitoring, configuration, or topology discovery tasks without deep SNMP expertise.
Developers choose OSS_SNMP because it dramatically reduces the learning curve and boilerplate code required for SNMP interactions, with pre-built support for common vendor MIBs and an extensible architecture that encourages community contributions.
Overview
A PHP SNMP library for people who hate SNMP, MIBs and OIDs!
Use Cases
Best For
- Automating VLAN configuration and monitoring on Cisco switches
- Discovering Layer 2 network topology via CDP or similar protocols
- Building custom network monitoring tools in PHP
- Retrieving system information (contact, location, uptime) from network devices
- Creating per-VLAN RSTP (Rapid Spanning Tree Protocol) port state visualizations
- Developing internal NOC (Network Operations Center) tools for network automation
Not Ideal For
- Projects requiring SNMP write operations for network configuration
- Teams working with network vendors not covered by pre-built MIBs (e.g., Juniper or Huawei)
- High-performance SNMP polling systems where abstraction overhead is a concern
Pros & Cons
Pros
Provides simple PHP methods like `vlanNames()` and `contact()` that abstract away complex OIDs, as shown in the example usage for retrieving VLAN names without manual translation.
Includes pre-built MIBs for Cisco and Foundry, enabling common tasks such as VLAN management and topology discovery via protocols like CDP, reducing initial setup time.
MIBs are defined in plain PHP files in the `MIBS/` directory, with a complete example in `Iface.php`, making it straightforward to add new functionality and contribute back.
Offers Layer 2 topology discovery capabilities, used in companion projects like NOCtools for network mapping, without needing separate tools for CDP-based analysis.
Cons
The library is currently read-only, as admitted in the README, so it cannot set SNMP values for configuration tasks, limiting its use in automation scenarios.
Only a handful of MIBs are pre-defined, primarily for Cisco and Foundry, which may require custom development for unsupported devices or advanced SNMP features.
Requires PHP 5.4 or higher, which might be restrictive for legacy systems or newer PHP environments, and dependencies like php5-snmp add setup complexity.
Frequently Asked Questions
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.