Einführung für PHP-Entwickler - Versionsgeschichte

Rising am 28. Dezember 2012 um 15:39 Uhr

2012-12-28T15:39:46Z

← Nächstältere Version		Version vom 28. Dezember 2012, 15:39 Uhr
Zeile 104:		Zeile 104:

	* [[API-Referenz (JSON-RPC)]]		* [[API-Referenz (JSON-RPC)]]
	* [~~https://en.bitcoin.it/wiki/Lazy_API Lazy~~ API]		* [[API für Faule]]
	* [https://en.bitcoin.it/wiki/eMerchant_Howto eMerchant Howto]		* [https://en.bitcoin.it/wiki/eMerchant_Howto eMerchant Howto]

Rising am 23. Dezember 2012 um 19:07 Uhr

2012-12-23T19:07:02Z

← Nächstältere Version		Version vom 23. Dezember 2012, 19:07 Uhr
Zeile 48:		Zeile 48:
	Bitcoinmengen können von einem Satoshi (0,00000001 BTC) bis 2,1 Billiarden Satoshis (21 Millionen BTC) reichen. Um Rundungsfehler zu vermelden, musst du sicherstellen, dass deine PHP-Implementation diese Werte unterstützt, ohne Ungenauigkeiten einzubauen. Die meisten PHP-Implementationen unterstützen IEEE-64-Bit-Gleitkommazahlen mit 53 Bits Genauigkeit; in diesem Fall können alle Werte korrekt verarbeitet werden.		Bitcoinmengen können von einem Satoshi (0,00000001 BTC) bis 2,1 Billiarden Satoshis (21 Millionen BTC) reichen. Um Rundungsfehler zu vermelden, musst du sicherstellen, dass deine PHP-Implementation diese Werte unterstützt, ohne Ungenauigkeiten einzubauen. Die meisten PHP-Implementationen unterstützen IEEE-64-Bit-Gleitkommazahlen mit 53 Bits Genauigkeit; in diesem Fall können alle Werte korrekt verarbeitet werden.

	Mehr Informationen findest du ~~auf~~ [~~https://en.bitcoin.it/wiki/Proper_Money_Handling_%28JSON~~-RPC~~%29 dieser Seite im englischen Wiki~~].		Mehr Informationen findest du unter [[Korrektes Handling von Geldbeträgen (JSON-RPC)\|Korrektes Handling von Geldbeträgen]].

	Falls deine PHP-Implementation 64-Bit-Gleitkommazahlen nicht unterstützen sollte (was sehr selten ist), musst du eine Version von bitcoind verwenden, die die Werte als Zeichenketten (Strings) sendet ("genjix" bietet eine solche Version unter [http://github.com/genjix/bitcoin] an) und die [http://php.net/manual/de/ref.gmp.php GMP-] und [http://php.net/manual/de/ref.bc.php BC-Math-]Libraries für alle Berechnungen verwenden.		Falls deine PHP-Implementation 64-Bit-Gleitkommazahlen nicht unterstützen sollte (was sehr selten ist), musst du eine Version von bitcoind verwenden, die die Werte als Zeichenketten (Strings) sendet ("genjix" bietet eine solche Version unter [http://github.com/genjix/bitcoin] an) und die [http://php.net/manual/de/ref.gmp.php GMP-] und [http://php.net/manual/de/ref.bc.php BC-Math-]Libraries für alle Berechnungen verwenden.

Rising am 23. Dezember 2012 um 19:04 Uhr

2012-12-23T19:04:58Z

← Nächstältere Version		Version vom 23. Dezember 2012, 19:04 Uhr
Zeile 3:		Zeile 3:
	Hier geht es um PHP, aber die Prinzipien sind natürlich in jeder Programmiersprache gleich. Informationen über andere Sprachen findest du in der [[API-Referenz (JSON-RPC)\|API-Referenz]].		Hier geht es um PHP, aber die Prinzipien sind natürlich in jeder Programmiersprache gleich. Informationen über andere Sprachen findest du in der [[API-Referenz (JSON-RPC)\|API-Referenz]].

	Die einfachste Möglichkeit ist es, Bitcoin als Daemon laufen zu lassen, mit dem PHP über lokale HTTP-Requests kommunizieren kann. Eine Library namens [http://jsonrpcphp.org/ JSON-RPC] wird verwendet, um die Funktionen von bitcoind aufzurufen. Bitcoind antwortet dann mit einem [http://de.wikipedia.org/wiki/~~Json~~ JSON-Objekt].		Die einfachste Möglichkeit ist es, Bitcoin als Daemon laufen zu lassen, mit dem PHP über lokale HTTP-Requests kommunizieren kann. Eine Library namens [http://jsonrpcphp.org/ JSON-RPC] wird verwendet, um die Funktionen von bitcoind aufzurufen. Bitcoind antwortet dann mit einem [http://de.wikipedia.org/wiki/JSON JSON-Objekt].

	== Bitcoin aufsetzen ==		== Bitcoin aufsetzen ==

Rising: /* "getnewaddress" vs. "getaccountaddress" */

2012-12-23T19:01:45Z

"getnewaddress" vs. "getaccountaddress"

← Nächstältere Version		Version vom 23. Dezember 2012, 19:01 Uhr
Zeile 99:		Zeile 99:
	</source>		</source>

	Dieses Codestück erzeugt eine neue Adresse pro Session und speichert sie in einer Session-Variable		Dieses Codestück erzeugt eine neue Adresse pro Session und speichert sie in einer Session-Variable.

	==Siehe auch==		==Siehe auch==

Rising am 23. Dezember 2012 um 18:59 Uhr

2012-12-23T18:59:23Z

← Nächstältere Version		Version vom 23. Dezember 2012, 18:59 Uhr
Zeile 106:		Zeile 106:
	* [https://en.bitcoin.it/wiki/Lazy_API Lazy API]		* [https://en.bitcoin.it/wiki/Lazy_API Lazy API]
	* [https://en.bitcoin.it/wiki/eMerchant_Howto eMerchant Howto]		* [https://en.bitcoin.it/wiki/eMerchant_Howto eMerchant Howto]

			== Hinweis ==

			Diese Seite wurde aus dem [https://en.bitcoin.it/wiki/PHP_developer_intro Englischen] übersetzt.

	[[es:Introducción para desarrolladores de PHP]]		[[es:Introducción para desarrolladores de PHP]]

Rising: /* Siehe auch */

2012-12-23T18:58:32Z

Siehe auch

← Nächstältere Version		Version vom 23. Dezember 2012, 18:58 Uhr
Zeile 104:		Zeile 104:

	* [[API-Referenz (JSON-RPC)]]		* [[API-Referenz (JSON-RPC)]]
	* [https://en.bitcoin.it/wiki/Lazy_API]		* [https://en.bitcoin.it/wiki/Lazy_API Lazy API]
	* [https://en.bitcoin.it/wiki/eMerchant_Howto]		* [https://en.bitcoin.it/wiki/eMerchant_Howto eMerchant Howto]

	[[es:Introducción para desarrolladores de PHP]]		[[es:Introducción para desarrolladores de PHP]]

Rising am 23. Dezember 2012 um 18:57 Uhr

2012-12-23T18:57:31Z

← Nächstältere Version		Version vom 23. Dezember 2012, 18:57 Uhr
Zeile 7:		Zeile 7:
	== Bitcoin aufsetzen ==		== Bitcoin aufsetzen ==

	Der Bitcoin-Daemon kann von der [[Hauptseite]] als Binary oder als Quellcode heruntergeladen werden. Details zum Thema Konfiguration von bitcoind findest du zur Zeit leider nur im englischen Wiki unter [[en:Running Bitcoin]].		Der Bitcoin-Daemon kann von der [[Hauptseite]] als Binary oder als Quellcode heruntergeladen werden. Details zum Thema Konfiguration von bitcoind findest du zur Zeit leider nur im englischen Wiki unter [https://en.bitcoin.it/wiki/Running_Bitcoin Running Bitcoin].

	Vor dem ersten Start von bitcoind musst du eine Konfigurationsdatei erstellen (~/.bitcoin/bitcoin.conf unter Linux). Erstellst du keine Konfigurationsdatei, warnt dich bitcoind beim Start.		Vor dem ersten Start von bitcoind musst du eine Konfigurationsdatei erstellen (~/.bitcoin/bitcoin.conf unter Linux). Erstellst du keine Konfigurationsdatei, warnt dich bitcoind beim Start.
Zeile 48:		Zeile 48:
	Bitcoinmengen können von einem Satoshi (0,00000001 BTC) bis 2,1 Billiarden Satoshis (21 Millionen BTC) reichen. Um Rundungsfehler zu vermelden, musst du sicherstellen, dass deine PHP-Implementation diese Werte unterstützt, ohne Ungenauigkeiten einzubauen. Die meisten PHP-Implementationen unterstützen IEEE-64-Bit-Gleitkommazahlen mit 53 Bits Genauigkeit; in diesem Fall können alle Werte korrekt verarbeitet werden.		Bitcoinmengen können von einem Satoshi (0,00000001 BTC) bis 2,1 Billiarden Satoshis (21 Millionen BTC) reichen. Um Rundungsfehler zu vermelden, musst du sicherstellen, dass deine PHP-Implementation diese Werte unterstützt, ohne Ungenauigkeiten einzubauen. Die meisten PHP-Implementationen unterstützen IEEE-64-Bit-Gleitkommazahlen mit 53 Bits Genauigkeit; in diesem Fall können alle Werte korrekt verarbeitet werden.

	Mehr Informationen findest du auf [[en~~:Proper Money Handling (JSON~~-RPC)\|dieser Seite im englischen Wiki]].		Mehr Informationen findest du auf [https://en.bitcoin.it/wiki/Proper_Money_Handling_%28JSON-RPC%29 dieser Seite im englischen Wiki].

	Falls deine PHP-Implementation 64-Bit-Gleitkommazahlen nicht unterstützen sollte (was sehr selten ist), musst du eine Version von bitcoind verwenden, die die Werte als Zeichenketten (Strings) sendet ("genjix" bietet eine solche Version unter [http://github.com/genjix/bitcoin] an) und die [http://php.net/manual/de/ref.gmp.php GMP-] und [http://php.net/manual/de/ref.bc.php BC-Math-]Libraries für alle Berechnungen verwenden.		Falls deine PHP-Implementation 64-Bit-Gleitkommazahlen nicht unterstützen sollte (was sehr selten ist), musst du eine Version von bitcoind verwenden, die die Werte als Zeichenketten (Strings) sendet ("genjix" bietet eine solche Version unter [http://github.com/genjix/bitcoin] an) und die [http://php.net/manual/de/ref.gmp.php GMP-] und [http://php.net/manual/de/ref.bc.php BC-Math-]Libraries für alle Berechnungen verwenden.
Zeile 56:		Zeile 56:
	Bei Bitcoin wird Geld an Adressen gesendet, wobei auf ein Wallet beliebig viele Adressen zeigen können. Standardmäßig zeigt bitcoind die Summe aller Bitcoins in allen Adressen, die zum Wallet gehören.		Bei Bitcoin wird Geld an Adressen gesendet, wobei auf ein Wallet beliebig viele Adressen zeigen können. Standardmäßig zeigt bitcoind die Summe aller Bitcoins in allen Adressen, die zum Wallet gehören.

	Allerdings kannst du auch Konten einrichten. Auch Konten können mehrere Adressen zugewiesen sein; jedes Konto agiert wie eine eigene Instanz [[en~~:Accounts explained\|~~Mehr Informationen im englischen Wiki]].		Allerdings kannst du auch Konten einrichten. Auch Konten können mehrere Adressen zugewiesen sein; jedes Konto agiert wie eine eigene Instanz [https://en.bitcoin.it/wiki/Accounts_explained Mehr Informationen im englischen Wiki].

	<source lang="bash">		<source lang="bash">
Zeile 69:		Zeile 69:
	In deiner Applikation sollte jeder Kunde einen eigenen Benutzernamen (also ein eigenes Konto) haben. Bitcoind gibt mit dem Befehl $bitcoin->getaccountaddress("user889"); die erste Adresse des Kontos "user889" aus; mit $bitcoin->getnewaddress("user889"); wird eine neue Adresse erzeugt und "user889" zugewiesen.		In deiner Applikation sollte jeder Kunde einen eigenen Benutzernamen (also ein eigenes Konto) haben. Bitcoind gibt mit dem Befehl $bitcoin->getaccountaddress("user889"); die erste Adresse des Kontos "user889" aus; mit $bitcoin->getnewaddress("user889"); wird eine neue Adresse erzeugt und "user889" zugewiesen.

	Der Kunde kann dann sein Geld auf diese Adresse einzahlen. Du kannst dann mit $bitcoin->getbalance("user889", 4); überprüfen, ob die Zahlung am Konto angekommen ist. Die 4 steht für die minimale Zahl an ~~Bestätigungen~~, die eingehen müssen, bis die Zahlung als gültig angesehen wird.		Der Kunde kann dann sein Geld auf diese Adresse einzahlen. Du kannst dann mit $bitcoin->getbalance("user889", 4); überprüfen, ob die Zahlung am Konto angekommen ist. Die 4 steht für die minimale Zahl an Bestätigung, die eingehen müssen, bis die Zahlung als gültig angesehen wird.

	Falls du Konten für mehrere Ein- und Auszahlungen längerfristig nutzen willst, ist es für dich möglicherweise sinnvoller, die Zahlungen in deiner eigenen Datenbank zu speichern. Das vereinfacht Transfers zwischen zwei Konten und löst die Verbindung zwischen Kundenkonten und Bitcoinkonten.		Falls du Konten für mehrere Ein- und Auszahlungen längerfristig nutzen willst, ist es für dich möglicherweise sinnvoller, die Zahlungen in deiner eigenen Datenbank zu speichern. Das vereinfacht Transfers zwischen zwei Konten und löst die Verbindung zwischen Kundenkonten und Bitcoinkonten.
Zeile 104:		Zeile 104:

	* [[API-Referenz (JSON-RPC)]]		* [[API-Referenz (JSON-RPC)]]
	* [[en:Lazy_API]]		* [https://en.bitcoin.it/wiki/Lazy_API]
	* [[en~~:Merchant Howto]~~]		* [https://en.bitcoin.it/wiki/eMerchant_Howto]

	[[es:Introducción para desarrolladores de PHP]]		[[es:Introducción para desarrolladores de PHP]]

Rising: Die Seite wurde neu angelegt: „Dieser Artikel ist für Entwickler geschrieben, die eine LAMP-Umgebung ('''L'''inux-'''A'''pache-'''M'''ySQL-'''P'''HP) zur Verfügung haben und eine Webanwend…“

2012-12-23T18:55:39Z

Die Seite wurde neu angelegt: „Dieser Artikel ist für Entwickler geschrieben, die eine LAMP-Umgebung ('''L'''inux-'''A'''pache-'''M'''ySQL-'''P'''HP) zur Verfügung haben und eine Webanwend…“

Neue Seite

Dieser Artikel ist für Entwickler geschrieben, die eine LAMP-Umgebung ('''L'''inux-'''A'''pache-'''M'''ySQL-'''P'''HP) zur Verfügung haben und eine Webanwendung entwickeln möchten, die mit dem Bitcoin-Netzwerk interagiert. Grundlegende Kenntnisse in Bitcoin und PHP sollten vorhanden sein.

Hier geht es um PHP, aber die Prinzipien sind natürlich in jeder Programmiersprache gleich. Informationen über andere Sprachen findest du in der [[API-Referenz (JSON-RPC)|API-Referenz]].

Die einfachste Möglichkeit ist es, Bitcoin als Daemon laufen zu lassen, mit dem PHP über lokale HTTP-Requests kommunizieren kann. Eine Library namens [http://jsonrpcphp.org/ JSON-RPC] wird verwendet, um die Funktionen von bitcoind aufzurufen. Bitcoind antwortet dann mit einem [http://de.wikipedia.org/wiki/Json JSON-Objekt].

== Bitcoin aufsetzen ==

Der Bitcoin-Daemon kann von der [[Hauptseite]] als Binary oder als Quellcode heruntergeladen werden. Details zum Thema Konfiguration von bitcoind findest du zur Zeit leider nur im englischen Wiki unter [[en:Running Bitcoin]].

Vor dem ersten Start von bitcoind musst du eine Konfigurationsdatei erstellen (~/.bitcoin/bitcoin.conf unter Linux). Erstellst du keine Konfigurationsdatei, warnt dich bitcoind beim Start.
<source lang="bash">
rpcuser=user
rpcpassword={hier aus Sicherheitsgründen ein starkes Passwort wählen}
</source>

Jetzt kannst du bitcoind starten:
<source lang="bash">
$ ./bitcoind
# warte einige Sekunden, während es startet.
$ ./bitcoind getinfo
# diverse Informationen werden angezeigt. Bekommst du einen Fehler, probiere es so lange erneut, bis du Daten bekommst.
$ ./bitcoind help
# für Hilfe zu den Befehlen
</source>

Bitcoind wird damit beginnen, mit dem Netzwerk zu synchronisieren, und wird die Blockchain komplett herunterladen. Derzeit (Dezember 2012) handelt es sich dabei um mehr als 2 GB Daten, die heruntergeladen und überprüft werden müssen. Es wird daher mehrere Stunden dauern. Du weißt, dass es fertig ist, wenn die Zahl der heruntergeladenen Blocks der [http://blockexplorer.com/q/getblockcount Nummer des aktuellen Blocks] entspricht.

== Getinfo (Bitcoinds Version von "Hello World") ==

Wenn bitcoind mit dem Initialisierungsprozess fertig ist und die Blockchain heruntergeladen hat, lade die Datei jsonRPCClient.php von [http://jsonrpcphp.org/ JSON-RPC PHP] herunter und platziere sie in einem Verzeichnis, aus dem der Webserver auf Dateien zugreifen kann.

Dann erzeuge eine PHP-Datei mit folgendem Inhalt und rufe sie mit dem Browser auf, um zu testen, ob alles funktioniert.

<source lang="php">
require_once 'jsonRPCClient.php';

$bitcoin = new jsonRPCClient('http://benutzername:passwort@127.0.0.1:8332/');

echo "<pre>\n";
print_r($bitcoin->getinfo());
echo "</pre>";
</source>

== Genauigkeit ==

Bitcoinmengen können von einem Satoshi (0,00000001 BTC) bis 2,1 Billiarden Satoshis (21 Millionen BTC) reichen. Um Rundungsfehler zu vermelden, musst du sicherstellen, dass deine PHP-Implementation diese Werte unterstützt, ohne Ungenauigkeiten einzubauen. Die meisten PHP-Implementationen unterstützen IEEE-64-Bit-Gleitkommazahlen mit 53 Bits Genauigkeit; in diesem Fall können alle Werte korrekt verarbeitet werden.

Mehr Informationen findest du auf [[en:Proper Money Handling (JSON-RPC)|dieser Seite im englischen Wiki]].

Falls deine PHP-Implementation 64-Bit-Gleitkommazahlen nicht unterstützen sollte (was sehr selten ist), musst du eine Version von bitcoind verwenden, die die Werte als Zeichenketten (Strings) sendet ("genjix" bietet eine solche Version unter [http://github.com/genjix/bitcoin] an) und die [http://php.net/manual/de/ref.gmp.php GMP-] und [http://php.net/manual/de/ref.bc.php BC-Math-]Libraries für alle Berechnungen verwenden.

== Konten ==

Bei Bitcoin wird Geld an Adressen gesendet, wobei auf ein Wallet beliebig viele Adressen zeigen können. Standardmäßig zeigt bitcoind die Summe aller Bitcoins in allen Adressen, die zum Wallet gehören.

Allerdings kannst du auch Konten einrichten. Auch Konten können mehrere Adressen zugewiesen sein; jedes Konto agiert wie eine eigene Instanz [[en:Accounts explained|Mehr Informationen im englischen Wiki]].

<source lang="bash">
$ ./bitcoind listaccounts
# zeige die Liste aller Konten und Infos über sie
$ ./bitcoind getaccountaddress user889
# zeige die erste Adresse, die dem Konto "user889" zugewiesen ist
$ ./bitcoind getbalance user889
# zeige die Summe des Geldes in allen Adressen an, die dem Konto "user889" zugewiesen sind
</source>

In deiner Applikation sollte jeder Kunde einen eigenen Benutzernamen (also ein eigenes Konto) haben. Bitcoind gibt mit dem Befehl $bitcoin->getaccountaddress("user889"); die erste Adresse des Kontos "user889" aus; mit $bitcoin->getnewaddress("user889"); wird eine neue Adresse erzeugt und "user889" zugewiesen.

Der Kunde kann dann sein Geld auf diese Adresse einzahlen. Du kannst dann mit $bitcoin->getbalance("user889", 4); überprüfen, ob die Zahlung am Konto angekommen ist. Die 4 steht für die minimale Zahl an Bestätigungen, die eingehen müssen, bis die Zahlung als gültig angesehen wird.

Falls du Konten für mehrere Ein- und Auszahlungen längerfristig nutzen willst, ist es für dich möglicherweise sinnvoller, die Zahlungen in deiner eigenen Datenbank zu speichern. Das vereinfacht Transfers zwischen zwei Konten und löst die Verbindung zwischen Kundenkonten und Bitcoinkonten.

=== "getnewaddress" vs. "getaccountaddress" ===

Die Verwendung von "getnewaddress" ermöglicht eine größere Anonymität für dich und deine Kunden, da immer neue Adressen es schwer machen, von außen die Geldflüsse zu verfolgen. Allerdings bedeutet es auch, dass dein Wallet mit zahlreichen neuen Adressen gefüllt wird.

Es wird daher empfohlen, die Zahl der Adressen, die ein Kunde verlangen kann, zu beschränken. Hier ein Beispiel (mit Sessions):
<source lang="php">
<?php
require_once('jsonRPCClient.php');
$bitcoin = new jsonRPCClient('http://root:root@127.0.0.1:8332/');
# überprüfe, ob Geld vorhanden ist
try {
$benutzername = ...
if(isset($_SESSION['sendeadresse']))
$sendeadresse = $_SESSION['sendeadresse'];
else {
$sendeadresse = $bitcoin->getnewaddress($benutzername);
$_SESSION['sendeadresse'] = $sendeadresse;
}
$balance = $bitcoin->getbalance($benutzername);
}
catch (Exception $e) {
die("<p>Serverfehler! Bitte den Administrator kontaktieren.</p>");
}
?>
</source>

Dieses Codestück erzeugt eine neue Adresse pro Session und speichert sie in einer Session-Variable

==Siehe auch==

* [[API-Referenz (JSON-RPC)]]
* [[en:Lazy_API]]
* [[en:Merchant Howto]]

[[es:Introducción para desarrolladores de PHP]]
[[en:PHP_developer_intro]]

[[Kategorie:Entwickler]]