README

A lightweight PHP library for interacting with the National Weather Service (weather.gov) API.
Provides alerts, daily forecasts, and hourly forecasts using a simple OOP interface.

Installation

composer require chaoswd/weather

Usage

use Chaoswd\Weather\Weather;

$weather = new Weather(
    userAgent: 'YourAppName (your-email@example.com)',
    lat: '47.6062',
    long: '-122.3321'
);

// Get alerts
$weather->getAlerts();
print_r($weather->alerts);

// Get daily forecast
$weather->getDailyForecast();
print_r($weather->daily);

// Get hourly forecast
$weather->getHourlyForecast();
print_r($weather->hourly);

// OR Chain methods
$weather->getAlerts()->getDailyForecast()->getHourlyForecast();
print_r($weather->daily);

Finding Your Latitude & Longitude

Use this tool (or any you prefer) to convert a U.S. ZIP code into latitude and longitude:
https://www.freemaptools.com/convert-us-zip-code-to-lat-lng.htm

API Notes

All requests are sent to https://api.weather.gov
A proper User-Agent string is required by the NWS API.
Format recommendation:
YourAppName (contact@example.com)
Review their documentation at https://www.weather.gov/documentation/services-web-api

Features

Fetch active weather alerts
Fetch full daily forecast
Fetch hourly forecast
Auto‑builds required forecast URLs using /points/{lat},{long} endpoint
Clean, chainable OOP interface

Requirements

PHP 8.3+
Composer
CURL

License

Licensed under the MIT license. See LICENSE for details.

chaoswd / weather

Maintainers

Details