PHP download

Download the PHP package randomhost/weather without Composer

On this page you can find all versions of the php package randomhost/weather. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download randomhost/weather
More information about randomhost/weather
Files in randomhost/weather

Vendor randomhost
Package weather
Short Description Encapsulates functions for easy retrieval of weather data from the Yahoo Weather API.
License BSD-3-Clause
Homepage https://www.random-host.com

Keywords weather

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.

Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.

Please rate this library. Is it a good library?

Example code of randomhost/weather

Informations about the package weather

NOTE: This package has been abandoned as of January 2019 due to Yahoo shutting down free access to their Weather API.

randomhost/weather

This package encapsulates functions for easy retrieval of weather data from the Yahoo Weather API. It was created as part of randomhost/webcamoverlay but is released as a separate component so it can be used in other packages.

Because it was created as a dependency of randomhost/webcamoverlay, it does only support a subset of the available weather data.

Usage

A basic approach at using this package could look like this:

This will instantiate the class, fetch the weather data and display current temperature and humidity.

Assuming that you named this file weather.php, you should now be able to access the weather data at http://example.com/weather.php

A more detailed example can be found in src/www/weather.php.

The Feed object

The Feed object is the primary object you will interact with in your application. It provides all methods required for retrieving data from the Yahoo! Weather API.

Constructor

The constructor takes 3 parameters which are all optional:

$locationName
Location name for retrieving weather data from the Yahoo Weather API.
$systemOfUnits
System of units to be returned by the feed. This must be either Feed::UNITS_INTL or Feed::UNITS_US.
$feedUrl
Feed URL for retrieving weather data from Yahoo Weather API.

If a $locationName is given, Feed::fetchData() will be called implicitly which will automatically retrieve weather data for the given location ID and populate the data access objects accordingly.
If you do not want this, you can omit $locationName or set it to '' (an empty string) and configure the location name yourself using Feed::setLocationName().

The $systemOfUnits parameter can be used to determine the system of units to be used by the weather feed. If not given or set to '' (an empty string), it defaults to using international units (Celsius, kilometers, millibars).

$feedUrl defines the feed URL for retrieving weather data from the Yahoo! Weather API. This parameter does not usually need to be changed unless Yahoo! changes their API.

Configuring the feed

The following public methods for configuring the weather feed are available:

setFeedUrl($feedUrl)
Sets the feed URL for retrieving weather data from the Yahoo! Weather API.
getFeedUrl()
Returns the last set weather API feed URL.
setLocationName($name)
Sets the location name for retrieving weather data from Yahoo Weather API.
getLocationName()
Returns the last set location name for retrieving weather data.
setSystemOfUnits($systemOfUnits)
Sets the system of units to be returned by the feed.
getSystemOfUnits()
Returns the last set system of units.

Retrieving data from the feed

The following public methods for retrieving data from the feed are available:

fetchData()
Fetches weather data from the Yahoo Weather API and populates the data access objects accordingly.
This method must be called at least once before using any of the methods listed below.
getLocation()
Returns a Data\Location object holding the location of this forecast.
getUnits()
Returns a Data\Units object holding units for various aspects of the forecast.
getWind()
Returns a Data\Wind object holding forecast information about wind.
getAtmosphere()
Returns a Data\Atmosphere object holding forecast information about current atmospheric pressure, humidity, and visibility.
getAstronomy()
Returns a Data\Astronomy object holding forecast information about current astronomical conditions.
getCondition()
Returns a Data\Condition object holding the current weather conditions.
getForecast()
Returns an array of Data\Forecast objects holding the weather forecast for a specific day.
getTitle()
Returns the title for the weather data as returned by Yahoo.
getLink()
Returns the link for linking weather data back to Yahoo.