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

IMDB
Class imdb

- mdb_config
-

class imdb
extends movie_base

Accessing IMDB information

Authors:
Georgos Giagas, Izzy (izzysoft AT qumran DOT org)
Version:
$Revision: 421 $ $Date: 2010-10-17 01:28:45 +0200 (So, 17. Okt 2010) $
Copyright:
(c) 2002-2004 by Giorgos Giagas and (c) 2004-2009 by Itzchak Rehberg and IzzySoft

Constructor Summary
void imdb(string $id)
Initialize the class

Method Summary
array alsoknow()
Get movies alternative names
array awards()
array[festivalName] is array[name,entries] - where name is a string, and entries is above described array
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 creator()
Get the creator of a movie (most likely for seasons only)
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_awards(string $html, string $table_start)
Get rows for the awards 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
boolean is_serial()
Try to figure out if this is a movie or part of a serie
array keywords()
Get the keywords for the movie
array keywords_all()
Get the complete 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
array locations()
Obtain filming locations
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([boolean $fallback])
Get the main Plot outline for the movie
array prodCompany()
Info about Production Companies
array 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)
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
protected 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 storyline()
Get the Storyline for the movie
string synopsis()
Get the movies synopsis
string tagline()
Get the main tagline for the movie
array taglines()
Get all available taglines for the movie
private boolean thumbphoto()
Setup cover photo (thumbnail and big variant)
string title()
Get movie title
private void title_year()
Setup title and year properties
integer top250()
Find the position of a movie in the top 250 ranked movies
mixed trailers([boolean $full])
Get the trailer URLs for a given movie
array trivia()
Get the trivia info
array videosites()
Get the off-site videos and trailer URLs
string votes()
Return votes for this movie
array writing()
Get the writer(s)
string year()
Get year

Methods inherited from class movie_base and not overridden
reset_vars

Methods inherited from class mdb_base and not overridden
cache_read, cache_write, get_pilot_imdbfill(), getWebPage, imdbid, monthNo, openpage, purge, set_pilot_imdbfill, setid

Constructor Detail

imdb()

void imdb(string $id)

Initialize the 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, "country" may hold multiple countries separated by commas
Version:
Due to changes on the IMDB sites, neither the languages nor the year seems to be available anymore - so those array properties will always be empty, and kept for compatibility only (for a while, at least). Moreover, content has been moved from the title page to ReleaseInfo page.
See also:
IMDB page ReleaseInfo

awards()

array awards()

Get the complete awards for the movie

Returns:
awards array[festivalName]['entries'][0..n] of array[year,won,category,award,people,comment]
Authors:
Qvist
See also:
IMDB page /awards

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

creator()

array creator()

Get the creator of a movie (most likely for seasons only)

Returns:
creator (array[0..n] of array[name,imdb])
See also:
IMDB page / (TitlePage)

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_awards()

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

Get rows for the awards table on the page

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

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

is_serial()

boolean is_serial()

Try to figure out if this is a movie or part of a serie

Returns:
See also:
IMDB page / (TitlePage)

keywords()

array keywords()

Get the keywords for the movie

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

keywords_all()

array keywords_all()

Get the complete keywords for the movie

Returns:
keywords
See also:
IMDB page /keywords

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)

locations()

array locations()

Obtain filming locations

Returns:
locations array[0..n] of array[name,url] with name being the name of the location, and url a relative URL to list other movies sharing this location
See also:
IMDB page /locations

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([boolean $fallback])

Get the main Plot outline for the movie

Parameters:
fallback - Fallback to storyline if we could not catch plotoutline? Default: FALSE
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()

array prodNotes()

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

Returns:
production notes [status,statnote,lastupdate[day,month,mon,year],more,note]
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

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()

protected 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

storyline()

string storyline()

Get the Storyline for the movie

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

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()

private 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


top250()

integer top250()

Find the position of a movie in the top 250 ranked movies

Returns:
position a number between 1..250 if the movie is listed, 0 otherwise
Authors:
abe
See also:
http://projects.izzysoft.de/trac/imdbphp/ticket/117

trailers()

mixed trailers([boolean $full])

Get the trailer URLs for a given movie

Parameters:
full - Retrieve all available data (TRUE), or stay compatible with previous IMDBPHP versions (FALSE, Default)
Returns:
trailers either array[0..n] of string ($full=FALSE), or array[0..n] of array[lang,title,url,restful_url ($full=TRUE)
See also:
IMDB page /trailers

trivia()

array trivia()

Get the trivia info

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

videosites()

array videosites()

Get the off-site videos and trailer URLs

Returns:
videosites array[0..n] of array(site,url,type,desc)
See also:
IMDB page /videosites

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.17-rc3.
Copyright © 2002-03 Stéphane GALLAND (under the GNU General Public License)