Overview   Package   Tree   Index 
IMDBPHP
PREV  NEXT Frames  No Frame 
SUMMARY:  FIELD | CONSTR | METHOD DETAIL:  FIELD | CONSTR | METHOD

Api
Class imdb

- imdb_config
-

class imdb
extends imdb_base

Accessing IMDB information

Authors:
Georgos Giagas, Izzy (izzysoft AT qumran DOT org)
Version:
$Revision: 225 $ $Date: 2009-09-25 13:37:29 +0200 (Fr, 25. Sep 2009) $
Copyright:
(c) 2002-2004 by Giorgos Giagas and (c) 2004-2009 by Itzchak Rehberg and IzzySoft

Constructor Summary
void imdb(string $id)
Initialize class

Method Summary
array alsoknow()
Get movies alternative names
array cast()
Get the actors
array colors()
Get colors
string comment()
Get movie main comment (from title page)
array comment_split()
Get movie main comment (from title page - split-up variant)
private void companyParse(string& $text, array& $parse)
Parse company info
array composer()
Obtain the composer(s) ("Original Music by...")
array country()
Get country of production
array crazy_credits()
Get the Crazy Credits
array director()
Get the director(s) of the movie
array distCompany()
Info about distributors
array episodes()
Get the series episode(s)
array extReviews()
Get list of external reviews (if any)
string genre()
There is not really a main genre on the IMDB sites (yet), so this simply returns the first one
array genres()
Get all genres the movie is registered for
private string get_imdbname(string $href)
Get the IMDB ID from a names URL
private array get_row_cels(string $row)
Get content of table row cells
private mixed get_table_rows(string $html, string $table_start)
Get rows for a given table on the page
private mixed get_table_rows_cast(string $html, string $table_start)
Get rows for the cast table on the page
array goofs()
Get the goofs
array keywords()
Get the keywords for the movie
string language()
There is not really a main language on the IMDB sites (yet), so this simply returns the first one
array languages()
Get all langauges this movie is available in
string main_url()
Set up the URL to the movie title page
array mainPictures()
Get URLs for the pictures on the main page
array movieconnection()
Get connected movie information
array movieTypes()
Get movie types (if any specified)
array mpaa()
Get the MPAA data (also known as PG or FSK)
array mpaa_hist()
Get the MPAA data (also known as PG or FSK) - including historical data
string mpaa_reason()
Find out the reason for the MPAA rating
array officialSites()
URLs of Official Sites
array otherCompany()
Info about other companies
array parentalGuide()
Detailed Parental Guide
private array parseConnection(string $conn)
Parse connection block (used by method movieconnection only)
mixed photo([boolean $thumb])
Get cover photo
mixed photo_localurl([boolean $thumb])
Get the URL for the movies cover photo
array plot()
Get the movies plot(s)
array plot_split()
Get the movie plot(s) - split-up variant
string plotoutline()
Get the main Plot outline for the movie
array prodCompany()
Info about Production Companies
void prodNotes()
For not-yet completed movies, we can get the production state
array producer()
Obtain the producer(s)
array quotes()
Get the quotes for a given movie
private void rate_vote()
Setup votes
string rating()
Get movie rating
array releaseInfo()
Obtain Release Info (if any)
private void reset_vars()
Reset page vars
mixed runtime()
Get overall runtime (first one mentioned on title page)
private string runtime_all()
Get general runtime
array runtimes()
Retrieve language specific runtimes
boolean savephoto(string $path, [boolean $thumb])
Save the photo to disk
integer seasons()
Get the number of seasons or 0 if not a series
private string set_pagename(string $wt)
Define page urls
array sound()
Get sound formats
array soundtrack()
Usually, the credits array should hold [0] written by, [1] performed by. But IMDB does not always stick to that - so in many cases it holds [0] performed by, [1] courtesy of
array specialCompany()
Info about Special Effects companies
string synopsis()
Get the movies synopsis
string tagline()
Get the main tagline for the movie
array taglines()
Get all available taglines for the movie
boolean thumbphoto()
Setup cover photo (thumbnail and big variant)
string title()
Get movie title
private void title_year()
Setup title and year properties
array trailers()
Get the trailer URLs for a given movie
array trivia()
Get the trivia info
string votes()
Return votes for this movie
array writing()
Get the writer(s)
string year()
Get year

Methods inherited from class imdb_base and not overridden
getWebPage, imdbid, monthNo, openpage, purge, setid

Constructor Detail

imdb()

void imdb(string $id)

Initialize class

Parameters:
id - IMDBID to use for data retrieval

Method Detail

alsoknow()

array alsoknow()

Get movies alternative names

Returns:
aka array[0..n] of array[title,year,country,comment]; searching on akas.imdb.com will add "lang" (2-char language code) to the array for localized names, "comment" will hold additional countries listed along for these as well as comments: As these things are quite mixed up on the imdb sites, it's hard to tell what is an additional country and what is a comment...
See also:
IMDB page / (TitlePage)

cast()

array cast()

Get the actors

Returns:
cast (array[0..n] of arrays[imdb,name,role,thumb,photo])
See also:
IMDB page /fullcredits

colors()

array colors()

Get colors

Returns:
colors (array[0..1] of strings)
See also:
IMDB page / (TitlePage)

comment()

string comment()

Get movie main comment (from title page)

Returns:
comment full text of movie comment from the movies main page
See also:
IMDB page / (TitlePage)

comment_split()

array comment_split()

Get movie main comment (from title page - split-up variant)

Returns:
comment array[string title, string date, array author, string comment]; author: array[string url, string name]
See also:
IMDB page / (TitlePage)

companyParse()

private void companyParse(string& $text, array& $parse)

Parse company info

Parameters:
text - to parse
parse - target

composer()

array composer()

Obtain the composer(s) ("Original Music by...")

Returns:
composer (array[0..n] of arrays[imdb,name,role])
See also:
IMDB page /fullcredits

country()

array country()

Get country of production

Returns:
country (array[0..n] of string)
See also:
IMDB page / (TitlePage)

crazy_credits()

array crazy_credits()

Get the Crazy Credits

Returns:
crazy_credits (array[0..n] of string)
See also:
IMDB page /crazycredits

director()

array director()

Get the director(s) of the movie

Returns:
director (array[0..n] of arrays[imdb,name,role])
See also:
IMDB page /fullcredits

distCompany()

array distCompany()

Info about distributors

Returns:
[0..n] of array (name,url,notes)
See also:
IMDB page /companycredits

episodes()

array episodes()

Get the series episode(s)

Returns:
episodes (array[0..n] of array[0..m] of array[imdbid,title,airdate,plot])
See also:
IMDB page /episodes

extReviews()

array extReviews()

Get list of external reviews (if any)

Returns:
[0..n] of array [url, desc] (or empty array if no data)
See also:
IMDB page /externalreviews

genre()

string genre()

Get the movies main genre Since IMDB.COM does not really now a "Main Genre", this simply means the first mentioned genre will be returned.

Returns:
genre first of the genres listed on the movies main page
See also:
IMDB page / (TitlePage)

genres()

array genres()

Get all genres the movie is registered for

Returns:
genres (array[0..n] of strings)
See also:
IMDB page / (TitlePage)

get_imdbname()

private string get_imdbname(string $href)

Get the IMDB ID from a names URL

Parameters:
href - url to the staff members IMDB page
Returns:
IMDBID of the staff member
See also:
used by the methods director, cast, writing, producer, composer

get_row_cels()

private array get_row_cels(string $row)

Get content of table row cells

Parameters:
row - (as returned by imdb::get_table_rows)
Returns:
cells (array[0..n] of strings)
See also:
used by the methods director, cast, writing, producer, composer

get_table_rows()

private mixed get_table_rows(string $html, string $table_start)

Get rows for a given table on the page

Parameters:
html -
table_start -
Returns:
rows (FALSE if table not found, array[0..n] of strings otherwise)
See also:
used by the methods director, cast, writing, producer, composer

get_table_rows_cast()

private mixed get_table_rows_cast(string $html, string $table_start)

Get rows for the cast table on the page

Parameters:
html -
table_start -
Returns:
rows (FALSE if table not found, array[0..n] of strings otherwise)
See also:
used by the method cast

goofs()

array goofs()

Get the goofs

Returns:
goofs (array[0..n] of array[type,content]
See also:
IMDB page /goofs

keywords()

array keywords()

Get the keywords for the movie

Returns:
keywords
See also:
IMDB page / (TitlePage)

language()

string language()

Get movies original language

Returns:
language
See also:
IMDB page / (TitlePage)

languages()

array languages()

Get all langauges this movie is available in

Returns:
languages (array[0..n] of strings)
See also:
IMDB page / (TitlePage)

main_url()

string main_url()

Set up the URL to the movie title page

Returns:
url full URL to the current movies main page

mainPictures()

array mainPictures()

Get URLs for the pictures on the main page

Returns:
[0..n] of [imgsrc, imglink, bigsrc], where
  • imgsrc is the URL of the thumbnail IMG as displayed on main page
  • imglink is the link to the page with the "big image"
  • bigsrc is the URL of the "big size" image itself
Authors:
moonface, izzy

movieconnection()

array movieconnection()

Get connected movie information

Returns:
connections (versionOf, editedInto, followedBy, spinOff, spinOffFrom, references, referenced, features, featured, spoofs, spoofed - each an array of mid, name, year, comment or an empty array if no connections of that type)
See also:
IMDB page /movieconnection

movieTypes()

array movieTypes()

Get movie types (if any specified)

Returns:
[0..n] of strings (or empty array if no movie types specified)
See also:
IMDB page / (TitlePage)

mpaa()

array mpaa()

Get the MPAA data (also known as PG or FSK)

Returns:
mpaa (array[country]=rating)
See also:
IMDB page / (TitlePage)

mpaa_hist()

array mpaa_hist()

Get the MPAA data (also known as PG or FSK) - including historical data

Returns:
mpaa (array[country][0..n]=rating)
See also:
IMDB page / (TitlePage)

mpaa_reason()

string mpaa_reason()

Find out the reason for the MPAA rating

Returns:
reason why the movie was rated such
See also:
IMDB page / (TitlePage)

officialSites()

array officialSites()

URLs of Official Sites

Returns:
[0..n] of url, name
See also:
IMDB page /officialsites

otherCompany()

array otherCompany()

Info about other companies

Returns:
[0..n] of array (name,url,notes)
See also:
IMDB page /companycredits

parentalGuide()

array parentalGuide()

Detailed Parental Guide

Returns:
of strings; keys: Alcohol, Sex, Violence, Profanity, Frightening - and maybe more; values: arguments for the rating
See also:
IMDB page /parentalguide

parseConnection()

private array parseConnection(string $conn)

Parse connection block (used by method movieconnection only)

Parameters:
conn - connection type
Returns:
[0..n] of array mid,name,year,comment - or empty array if not found

photo()

mixed photo([boolean $thumb])

Get cover photo

Parameters:
thumb - get the thumbnail (100x140, default) or the bigger variant (400x600 - FALSE)
Returns:
photo (string url if found, FALSE otherwise)
See also:
IMDB page / (TitlePage)

photo_localurl()

mixed photo_localurl([boolean $thumb])

Get the URL for the movies cover photo

Parameters:
thumb - get the thumbnail (100x140, default) or the bigger variant (400x600 - FALSE)
Returns:
url (string URL or FALSE if none)
See also:
IMDB page / (TitlePage)

plot()

array plot()

Get the movies plot(s)

Returns:
plot (array[0..n] of strings)
See also:
IMDB page /plotsummary

plot_split()

array plot_split()

Get the movie plot(s) - split-up variant

Returns:
array[0..n] of array[string plot,array author] - where author consists of string name and string url
See also:
IMDB page /plotsummary

plotoutline()

string plotoutline()

Get the main Plot outline for the movie

Returns:
plotoutline
See also:
IMDB page / (TitlePage)

prodCompany()

array prodCompany()

Info about Production Companies

Returns:
[0..n] of array (name,url,notes)
See also:
IMDB page /companycredits

prodNotes()

void prodNotes()

For not-yet completed movies, we can get the production state

See also:
IMDB page / (TitlePage)

producer()

array producer()

Obtain the producer(s)

Returns:
producer (array[0..n] of arrays[imdb,name,role])
See also:
IMDB page /fullcredits

quotes()

array quotes()

Get the quotes for a given movie

Returns:
quotes (array[0..n] of string)
See also:
IMDB page /quotes

rate_vote()

private void rate_vote()

Setup votes


rating()

string rating()

Get movie rating

Returns:
rating current rating as given by IMDB site
See also:
IMDB page / (TitlePage)

releaseInfo()

array releaseInfo()

Obtain Release Info (if any)

Returns:
release_info array[0..n] of strings (country,day,month,mon, year,comment) - "month" is the month name, "mon" the number
See also:
IMDB page /releaseinfo

reset_vars()

private void reset_vars()

Reset page vars


runtime()

mixed runtime()

Get overall runtime (first one mentioned on title page)

Returns:
string runtime in minutes (if set), NULL otherwise
See also:
IMDB page / (TitlePage)

runtime_all()

private string runtime_all()

Get general runtime

Returns:
runtime complete runtime string, e.g. "150 min / USA:153 min (director's cut)"

runtimes()

array runtimes()

Retrieve language specific runtimes

Returns:
runtimes (array[0..n] of array[time,country,comment])
See also:
IMDB page / (TitlePage)

savephoto()

boolean savephoto(string $path, [boolean $thumb])

Save the photo to disk

Parameters:
path - where to store the file
thumb - get the thumbnail (100x140, default) or the bigger variant (400x600 - FALSE)
Returns:
success
See also:
IMDB page / (TitlePage)

seasons()

integer seasons()

Get the number of seasons or 0 if not a series

Returns:
seasons number of seasons
See also:
IMDB page / (TitlePage)

set_pagename()

private string set_pagename(string $wt)

Define page urls

Parameters:
wt - internal name of the page
Returns:
urlname page URL

sound()

array sound()

Get sound formats

Returns:
sound (array[0..n] of strings)
See also:
IMDB page / (TitlePage)

soundtrack()

array soundtrack()

Get the soundtrack listing

Returns:
soundtracks (array[0..n] of array(soundtrack,array[0..n] of credits)
See also:
IMDB page /soundtrack

specialCompany()

array specialCompany()

Info about Special Effects companies

Returns:
[0..n] of array (name,url,notes)
See also:
IMDB page /companycredits

synopsis()

string synopsis()

Get the movies synopsis

Returns:
synopsis
See also:
IMDB page /synopsis

tagline()

string tagline()

Get the main tagline for the movie

Returns:
tagline
See also:
IMDB page / (TitlePage)

taglines()

array taglines()

Get all available taglines for the movie

Returns:
taglines (array[0..n] of strings)
See also:
IMDB page /taglines

thumbphoto()

boolean thumbphoto()

Setup cover photo (thumbnail and big variant)

Returns:
success (TRUE if found, FALSE otherwise)
See also:
IMDB page / (TitlePage)

title()

string title()

Get movie title

Returns:
title movie title (name)
See also:
IMDB page / (TitlePage)

title_year()

private void title_year()

Setup title and year properties


trailers()

array trailers()

Get the trailer URLs for a given movie

Returns:
trailers (array[0..n] of string)
See also:
IMDB page /trailers

trivia()

array trivia()

Get the trivia info

Returns:
trivia (array[0..n] string
See also:
IMDB page /trivia

votes()

string votes()

Return votes for this movie

Returns:
votes count of votes for this movie
See also:
IMDB page / (TitlePage)

writing()

array writing()

Get the writer(s)

Returns:
writers (array[0..n] of arrays[imdb,name,role])
See also:
IMDB page /fullcredits

year()

string year()

Get year

Returns:
year
See also:
IMDB page / (TitlePage)

 Overview   Package   Tree   Index 
IMDBPHP
PREV  NEXT Frames  No Frame 
SUMMARY:  FIELD | CONSTR | METHOD DETAIL:  FIELD | CONSTR | METHOD

Submit a bug

This document was generated by phpdocgen 0.16.
Copyright © 2002-03 Stéphane GALLAND (under the GNU General Public License)